POST products/create

Available from CRM.COM R14.0.0

This method creates a product. A single product is created by each call

Resource URL

Parameters

Name

Type

Description

token

String

The token retrieved from the login method

code

(mandatory)

String

The code of the new product

alternative_code

(mandatory)

String

The alternative code of the new product

description

(mandatory)

String

The description of the new product

long_description

(optional)

String

A long description of the retrieved product

priority_level

(optional)

Integer

The priority level of the product

type_identifier

(mandatory)

Identifier

The product type identifier of the new product. The allowed product type identifier fields are the following:

Name

Type

Description

id

(semi-optional)

String

The ID of the product type

name

(semi-optional)

String

The name of the product type

alternative_code

(semi-optional)

String

The alternative code of a product type

brand_identifier

(optional)

Identifier

The product brand identifier of the new product. The allowed product type identifier fields are the following:

Name

Type

Description

id

(semi-optional)

String

The ID of the product brand

name

(semi-optional)

String

The name of the product brand

alternative_code

(semi-optional)

String

The alternative code of a product brand

family_identifier

(optional)

Identifier

The product family identifier of the new product. The allowed product type identifier fields are the following:

Name

Type

Description

id

(semi-optional)

String

The ID of the product family

name

(semi-optional)

String

The name of the product family

code

(semi-optional)

String

The code of a product family

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

global_rate

(optional)

Global Rate object

The rate (price) that the product will have in the Global Price Plan

Available from CRM.COM R15.0.0

validity_set

(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

categories_set

(optional)

Set of Product Category Objects

The product category of the new product

tax_rate_set

(optional)

Set of Tax Rate Objects

The Tax rates of the current period that will be applied on the new product

vat_rate_set

(optional)

Set of Vat Rate Objects

The Vat rates of the current period that will be applied on the new product

components_set

(applicable and mandatory on conditions)

Set of Bundle Components Objects

The components of the new product

This parameter is applicable and possibly mandatory only if the product is classified as a fixed or flexible bundle

bundle_restrictions

(optional)

Bundle Restrictions Object

The bundle restrictions of the new product

This parameter is applicable only if the product is classified as a flexible bundle

upsells_set

(optional)

Set of Upsell Products Object

The upsell products associated to the specific product

Available from CRM.COM R15.0.0

cross_sells_set

(optional)

Set of cross-sell Products Object

The cross-sell products associated to the specific product

Available from CRM.COM R15.0.0

metadata_set

(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_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

Traceable Physical Good

Available from CRM.COM R15.0.0

You can only add existing metadata attributes.

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

product_validity parameter object data

Name

Type

Description

valid_from

(mandatory)

Date

The date that the product will become valid

valid_to

(optional)

Date

The date that the product will become invalid. This is optional as a product can be valid for ever, starting from a specific date

product_categories parameter object data

Name

Type

Description

category_identifier

(mandatory)

Product Category Identifier

The identifier of the product category. The allowed product categories identifier fields are the following:

Name

Type

Description

id

(semi-optional)

String

The ID of the product category

name

(semi-optional)

String

The name of the product category

code

(semi-optional)

String

The code of a product category

product_rate parameter object data

Name

Type

Description

rate_identifier

(mandatory)

Rate Identifier

The identifier of the identifier. The allowed identifier fields are the following:

Name

Type

Description

id

(semi-optional)

String

The ID of the rate

name

(semi-optional)

String

The name of the rate

alternative_code

(semi-optional)

String

The alternative code of the rate

product_bundle_components parameter object data

Name

Type

Description

product

(semi-optional)

Product Identifier

The identifier of the product. The allowed product identifier fields are the following:

Name

Type

Description

id

(semi-optional)

String

The ID of the product

code

(semi-optional)

String

The code of the product

alternative_code

(semi-optional)

String

The alternative code of the product

product_type

(semi-optional)

Product Type Identifier

The identifier of the product type. The allowed product type identifier fields are the following:

Name

Type

Description

id

(semi-optional)

String

The ID of the product type

name

(semi-optional)

String

The name of the product type

alternative_code

(semi-optional)

String

The alternative code of a product type

Applicable only for products of classification SERVICE

product_family

(semi-optional)

Product Family Identifier

The identifier of the product family. The allowed product family identifier fields are the following:

Name

Type

Description

id

(semi-optional)

String

The ID of the product family

name

(semi-optional)

String

The name of the product family

code

(semi-optional)

String

The code of a product family

Applicable only for products of classification SERVICE

is_mandatory

(optional)

Boolean

Defines whether the product (as part of the product / product family / product family) should be a mandatory part of the bundle or not

By default the value should be set to True / 1
Applicable only for products of composition FLEXIBLEBUNDLE

Available from CRM.COM R17.0.0

quantity

(optional)

Number

Defines the quantity of the product component

Applicable only for

FIXED bundle products, and
When the "product" parameter is specified

minimum_quantity

(optional)

Number

Defines the minimum number of products that can be added for the specific product type or product family

Applicable only for

Products of classification SERVICE, and
FLEXIBLE bundles and
When the "product_type" or "product_family" parameter is specified

maximum_quantity

(optional)

Number

Defines the maximum number of products that can be added for the specific product type or product family

Applicable only for

Products of classification SERVICE, and
FLEXIBLE bundles, and
When the "product_type" or "product_family" parameter is specified

product_bundle_restricitions parameter object data

Name

Type

Description

number_of_product_types_restriction

(optional)

Number

Restricts the number of product types that products can be used from

Applicable only for FLEXIBLE bundle products

number_of_product_families_restriction

(optional)

Number

Restricts the number of product families that products can be used from

Applicable only for FLEXIBLE bundle products

global_rate object parameter data

Name	Type	Description
base_amount (mandatory)	Number	The base rate that is applied if not tiered rates are applied
rate_model (mandatory on conditions)	String	The rate model of the retrieved price plan rate which is applicable only if the product type is of a product classification/service type Termed Service. Available values are: QUANTITYANDPERIODBASED BILLABLEPERIODBASED For any of the other product classification/type the rate model is automatically set. The applicable values are as follows: QUANTITYBASED QUANTITYANDPERIODBASED BILLABLEPERIODBASED DURATIONBASED FLATFEEBASED (FLATRATE) USAGEBASED (NEW) From CRM.COM R17.0.0, QUANTITYANDMATURITYBASED is renamed to QUANTITYANDPERIODBASED
base_rate_applied_per (mandatory on conditions)	String	Determines whether the amount provided is per period or period and quantity. The following options are available Period Period & Item Mandatory and applicable only for 'Period & Quantity' Based rate model
uot (mandatory on conditions)	String	The unit of time used for one-time services rates. The following options are available SECONDS MINUTES HOUR DAY WEEK MONTH YEAR Mandatory and applicable only for one-time services (Duration rate model)
uom (mandatory on conditions)	String	Unit of Measurement represents the unit of measurement that can be used in the system in order to measure usage UOM are configurable. Mandatory and applicable only for usage services (Usage based rate model)
time_period (mandatory on conditions)	Time Period Object	The period and unit of time used for termed services rates. Mandatory and applicable only on termed services rates.

Referred Objects Data

time period parameter object data

Name

Type

Description

time_period_value

(mandatory)

Number

The time period value

time_period_uot

(mandatory)

String

The time period unit of time

The supported values are the following: MINUTES, HOURS, DAYS, WEEKS, MONTHS, YEARS

upsells parameter object data

Name

Type

Description

product_identifier

(mandatory)

Products identifier

The product that will be set as an upsell. The allowed product identifier fields are the following:

Name

Type

Description

id

(semi-optional)

String

The ID of the product

code

(semi-optional)

String

The code of the product

alternative_code

(semi-optional)

String

The alternative code of the product

upsell_priority

(optional)

Integer

The priority which can be used by the 3rd party system to decide the order by which the product will be displayed in relation to other upsell products

cross-sells parameter object data

Name

Type

Description

product_identifier

(mandatory)

Products identifier

The product that will be used as a cross-sell. The allowed product identifier fields are the following:

Name

Type

Description

id

(semi-optional)

String

The ID of the product

code

(semi-optional)

String

The code of the product

alternative_code

(semi-optional)

String

The alternative code of the product

cross_sell_priority

(optional)

Integer

The priority which can be used by the 3rd party system to decide the order by which the product will be displayed in relation to other cross-sell products

metadata attribute value parameter data

Name	Type	Description
key	String	The key of the metadata field for which a value will be provided
value	String	The value of the metadata field

allowed metadata attribute parameter data

Name

Type

Description

allowed_metadata_identifier

String

The identifier of the metadata attribute which should be made available for entities of this entity/entity type. For example, when creating products of a specific product type.The allowed metadata identifier fields are the following:

Name

Type

Description

id

(semi-optional)

String

The ID of the metadata attribute

key

(semi-optional)

String

The key of the metadata attribute

is_mandatory

Boolean

Define whether it is mandatory to provide a value for this attribute when creating entities using this entity/entity type.

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
type	Product Type Object	The type of the retrieved product
brand	Product Brand Object	The brand of the retrieved product
family	Product Family Object	The product family of the retrieved product
log_information	Log Information Object	The Log Information related with the retrieved product
bundle_restrictions	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
price_plans_set	Set of Price Plans Object	The Price Plans containing the retrieved product
validity_set	Set of Product Validity Object	The Product validity of the retrieved product (If is empty then the product is always valid)
categories_set	Set of Product to Product Category Object	The Product Categories of the retrieved product
components_set	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
vat_rate_set	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

product_type object data response

Name	Type	Description
Id	String	The ID of the retrieved product type
name	String	The Name of the retrieved product type
alternative_code	String	The Alternative Code of the retrieved product type
description	String	The Description of the retrieved product type
classification	String	The Classification of the retrieved product type which can be SERVICES or PHYSICALGOODS
service_type	String	The Service Type of the retrieved product type which can be TERMED, USAGE, ONETIME or EXPENSE
physical_good_type	String	The physical Good Type of the retrieved product type which can be TRACEABLE or NONTRACEABLE
composition_method	String	The Composition Method of the retrieved product type which can be FLAT, FLEXIBLEBUNDLE or FIXEDBUNDLE
used_for_provisioning	Boolean	The flag shows if the retrieved product type is used for provisioning
udr_type	Usage Detail Record Type	The UDR type related with the product type. This is applicable only if the product type is classified as SERVICES and the service type is set to USAGE
meter_reading_type	Meter Reading Type	The Meter Reading type related with the product type. This is applicable only for traceable physical goods Available from CRM.COM R14.0.0

Referred Objects Response Data

usage_detail_record_type object data response

Name	Type	Description
Id	String	The ID of the retrieved usage detail record type
name	String	The Name of the retrieved usage detail record type
alternative_code	String	The Alternative Code of the retrieved usage detail record type
description	String	The Description of the retrieved usage detail record type
unit_of_measurement	String	The Unit of measurement of the retrieved usage detail record type

Referred Objects Response Data

unit_of_measurement object response data

Name	Type	Description
id	String	The identifier of the Unit of measurement
name	String	The name of the Unit of measurement
description	String	The description of the Unit of measurement
alternative_code	String	The alternative code of the Unit of measurement

meter_reading_type object data response

Name	Type	Description
Id	String	The ID of the retrieved meter reading type
name	String	The Name of the retrieved meter reading type
alternative_code	String	The Alternative Code of the retrieved meter reading type
classification	String	The Classification of the retrieved meter reading type
description	String	The Description of the retrieved meter reading type
unit_of_measurement	String	The Unit of measurement of the retrieved meter reading type

Referred Objects Response Data

unit_of_measurement object response data

Name	Type	Description
id	String	The identifier of the Unit of measurement
name	String	The name of the Unit of measurement
description	String	The description of the Unit of measurement
alternative_code	String	The alternative code of the Unit of measurement

product_brand object data response

Name	Type	Description
Id	String	The ID of the retrieved product brand
name	String	The Name of the retrieved product brand
alternative_code	String	The Alternative Code of the retrieved product brand
description	String	The Description of the retrieved product brand

product_family object data response

Name	Type	Description
Id	String	The ID of the retrieved product family
name	String	The Name of the retrieved product family
code	String	The code of the retrieved product family
description	String	The Description of the retrieved product family

tax_rate response data object

Name	Type	Description
id	String	The ID of the retrieved Tax rate
name	String	The Name of the retrieved Tax rate
alternative_code	String	The Alternative Code of the retrieved Tax rate
description	String	The Description of the retrieved Tax rate

vat_rate response data object

Name	Type	Description
Id	String	The ID of the retrieved vat rate
name	String	The Name of the retrieved vat rate
alternative_code	String	The Alternative Code of the retrieved vat rate
description	String	The Description of the retrieved vat rate

global rate object response data

Name	Type	Description
id	String	The ID of the retrieved rate
rate_model	String	The price plan rate model which can be one of the following: QUANTITYBASED QUANTITYANDPERIODBASED BILLABLEPERIODBASED DURATIONBASED FLATFEEBASED USAGEBASED From CRM.COM R17.0.0, QUANTITYANDMATURITYBASED is renamed to QUANTITYANDPERIODBASED
global_base_amount	Number	The base price of the product in the Global Price Plan
base_rate_applied_per	String	The value for 'Base Rate Applied per' Available when the rate model is 'Quantity & Quantity Based' and it is a selection between Period Period_Item
uot	String	The 'UOT' applicable for the rate Seconds Minute Hour Day Week Month Year Available for one-time services
time_period	Time Period Object	The period and unit of time for which the base amount is applicable for. This is available only on termed services rates.
uom	String	The 'UOM' applicable for the rate Available when the product type is of Usage Service Classification

Referred Objects Response Data

period object response data

Name

Type

Description

time_period_value

Number

The time period value

time_period_uot

String

The time period unit of time. The supported values are the following:

MINUTES, HOURS, DAYS, WEEKS, MONTHS, YEARS

log_information object response data

Name	Type	Description
created_date	Date	The date that the retrieved record was created
updated_date	Date	The last date that the retrieved record was updated
created_by_unit	Unit Object	The unit that created the retrieved record From CRM.COM R14.1.0 and onward, group_name and community_name attributes will be returned as empty, if the related legacy compatibility setting is disabled Deprecated from CRM.COM R18.0.0
created_by_business_unit	Unit Object	The unit that created the retrieved record From CRM.COM R14.1.0 and onward, group_name and community_name attributes will be returned as empty, if the related legacy compatibility setting is disabled Available from CRM.COM R18.0.0
created_by_user	User Object	The user that created the retrieved record From CRM.COM R14.1.0 and onward, person_name and email attributes will be returned as empty, if the related legacy compatibility setting is disabled
updated_by_unit	Unit Object	The last unit that updated the retrieved record From CRM.COM R14.1.0 and onward, group_name and community_name attributes will be returned as empty, if the related legacy compatibility setting is disabled Deprecated from CRM.COM R18.0.0
updated_by_business_unit	Unit Object	The last unit that updated the retrieved record Available from CRM.COM R18.0.0
updated_by_user	User Object	The last user that updated the retrieved record From CRM.COM R14.1.0 and onward, person_name and email attributes will be returned as empty, if the related legacy compatibility setting is disabled

Referred Objects Response Data

unit object response data

Name	Type	Description
id	String	The ID of the retrieved unit
name	String	The name of the retrieved unit
group_name	String	The name of the group that the retrieved unit belongs to
community_name	String	The name of the community that the retrieved unit belongs to
alternative_code	String	The alternative code of the retrieved unit
description	String	The description of the retrieved unit

business unit object response data

Name	Type	Description
id	String	The ID of the retrieved business unit
name	String	The name of the retrieved business unit
code	String	The code of the retrieved business unit
unified_code	String	The unified code of the retrieved business unit
description	String	The description of the retrieved business unit
parent_business_unit_name	String	The name of the parent business unit that the retrieved business unit belongs to

user object response data

Name	Type	Description
id	String	The ID of the retrieved user
username	String	The user name of the retrieved user
person_name	String	The full name of the retrieved user
email	String	The email of the retrieved user

price_plan object data response

Name	Type	Description
Id	String	The ID of the retrieved price plan
name	String	The Name of the retrieved price plan
code	String	The Code of the retrieved price plan
description	String	The Description of the retrieved price plan
type	String	The Type of the retrieved price plan which can be BASE or CONDITIONAL
effective_date	Date	The Effective Date of the retrieved price plan
expiration_date	Date	The Expiration Date of the retrieved price plan
currency	Currency Object	The Currency of the retrieved price plan Available from CRM.COM R14.2.0

Referred Objects Response Data

currency object response data

Name	Type	Description
id	String	The ID of the retrieved currency
code	String	The code of the retrieved currency
prefix_symbol	String	The prefix symbol for the specified currency
suffix_symbol	String	The suffix symbol for the specified currency
life_cycle_state	String	The life cycle state for the specified currency, which can be EFFECTIVE or NOT EFFECTIVE Available from CRM.COM R14.0.0
integer_part_name	String	The integer part name for the specified currency
decimal_part_name	String	The decimal part name for the specified currency

product_validity object data response

Name	Type	Description
id	String	The ID of the product validity
valid_from	Date	The date that the product should become valid
valid_to	Date	The date that the product should become invalid. This is optional as a product can be valid for ever, starting from a specific date

product_to_product_category object data response

Name	Type	Description
Id	String	The ID of the retrieved product to product category component
category	Product Category Object	The product category of the retrieved product to product category component

Referred Objects Response Data

product_category response data object

Name	Type	Description
Id	String	The ID of the retrieved product category
name	String	The Name of the retrieved product category
code	String	The code of the retrieved product category
description	String	The Description of the retrieved product category

product_component object data response

Name	Type	Description
Id	String	The ID of the retrieved product component
quantity	float	The quantity of the product component. Available only for fixed bundle products
is_mandatory	Boolean	Defines whether the product should be provided as mandatory for the bundle or not Available from CRM.COM R17.0.0
min_quantity	float	The minimum required quantity of the product component. Available only for flexible bundle products
max_quantity	float	The minimum required quantity of the product component. Available only for flexible bundle products
product	Product Object	The product of the retrieved product component
product_type	Product Type Object	The product type of the retrieved product components. Available only for flexible bundle products
product_family	Product Family Object	The product family of the retrieved product components. Available only for flexible bundle products

Referred Objects Response Data

product object response data

Name	Type	Description
Id	String	The ID of the product
code	String	The code of product
alternative_code	String	The alternative code of product
description	String	The description of product
priority_level	Integer	The priority level of the product Available from CRM.COM R12.3.0
global_rate	Global Rate Object	The global rate of the retrieved product Available from CRM.COM R15.0.0
product_type	Product type object	The type of the product

Referred Objects Response Data

product_type object data response

Name	Type	Description
Id	String	The ID of the retrieved product type
name	String	The Name of the retrieved product type
alternative_code	String	The Alternative Code of the retrieved product type
description	String	The Description of the retrieved product type
classification	String	The Classification of the retrieved product type which can be SERVICES or PHYSICALGOODS
service_type	String	The Service Type of the retrieved product type which can be TERMED, USAGE, ONETIME or EXPENSE
physical_good_type	String	The physical Good Type of the retrieved product type which can be TRACEABLE or NONTRACEABLE
composition_method	String	The Composition Method of the retrieved product type which can be FLAT, FLEXIBLEBUNDLE or FIXEDBUNDLE
used_for_provisioning	Boolean	The flag shows if the retrieved product type is used for provisioning
udr_type	Usage Detail Record Type	The UDR type related with the product type. This is applicable only if the product type is classified as SERVICES and the service type is set to USAGE
meter_reading_type	Meter Reading Type	The Meter Reading type related with the product type. This is applicable only for traceable physical goods Available from CRM.COM R14.0.0

Referred Objects Response Data

usage_detail_record_type object data response

Name	Type	Description
Id	String	The ID of the retrieved usage detail record type
name	String	The Name of the retrieved usage detail record type
alternative_code	String	The Alternative Code of the retrieved usage detail record type
description	String	The Description of the retrieved usage detail record type
unit_of_measurement	String	The Unit of measurement of the retrieved usage detail record type

Referred Objects Response Data

unit_of_measurement object response data

Name	Type	Description
id	String	The identifier of the Unit of measurement
name	String	The name of the Unit of measurement
description	String	The description of the Unit of measurement
alternative_code	String	The alternative code of the Unit of measurement

meter_reading_type object data response

Name	Type	Description
Id	String	The ID of the retrieved meter reading type
name	String	The Name of the retrieved meter reading type
alternative_code	String	The Alternative Code of the retrieved meter reading type
classification	String	The Classification of the retrieved meter reading type
description	String	The Description of the retrieved meter reading type
unit_of_measurement	String	The Unit of measurement of the retrieved meter reading type

Referred Objects Response Data

unit_of_measurement object response data

Name	Type	Description
id	String	The identifier of the Unit of measurement
name	String	The name of the Unit of measurement
description	String	The description of the Unit of measurement
alternative_code	String	The alternative code of the Unit of measurement

global rate object response data

Name	Type	Description
id	String	The ID of the retrieved rate
rate_model	String	The price plan rate model which can be one of the following: QUANTITYBASED QUANTITYANDPERIODBASED BILLABLEPERIODBASED DURATIONBASED FLATFEEBASED USAGEBASED From CRM.COM R17.0.0, QUANTITYANDMATURITYBASED is renamed to QUANTITYANDPERIODBASED
global_base_amount	Number	The base price of the product in the Global Price Plan
base_rate_applied_per	String	The value for 'Base Rate Applied per' Available when the rate model is 'Quantity & Quantity Based' and it is a selection between Period Period_Item
uot	String	The 'UOT' applicable for the rate Seconds Minute Hour Day Week Month Year Available for one-time services
time_period	Time Period Object	The period and unit of time for which the base amount is applicable for. This is available only on termed services rates.
uom	String	The 'UOM' applicable for the rate Available when the product type is of Usage Service Classification

Referred Objects Response Data

period object response data

Name

Type

Description

time_period_value

Number

The time period value

time_period_uot

String

The time period unit of time. The supported values are the following:

MINUTES, HOURS, DAYS, WEEKS, MONTHS, YEARS

product_type object data response

Name	Type	Description
Id	String	The ID of the retrieved product type
name	String	The Name of the retrieved product type
alternative_code	String	The Alternative Code of the retrieved product type
description	String	The Description of the retrieved product type
classification	String	The Classification of the retrieved product type which can be SERVICES or PHYSICALGOODS
service_type	String	The Service Type of the retrieved product type which can be TERMED, USAGE, ONETIME or EXPENSE
physical_good_type	String	The physical Good Type of the retrieved product type which can be TRACEABLE or NONTRACEABLE
composition_method	String	The Composition Method of the retrieved product type which can be FLAT, FLEXIBLEBUNDLE or FIXEDBUNDLE
used_for_provisioning	Boolean	The flag shows if the retrieved product type is used for provisioning
udr_type	Usage Detail Record Type	The UDR type related with the product type. This is applicable only if the product type is classified as SERVICES and the service type is set to USAGE
meter_reading_type	Meter Reading Type	The Meter Reading type related with the product type. This is applicable only for traceable physical goods Available from CRM.COM R14.0.0

Referred Objects Response Data

usage_detail_record_type object data response

Name	Type	Description
Id	String	The ID of the retrieved usage detail record type
name	String	The Name of the retrieved usage detail record type
alternative_code	String	The Alternative Code of the retrieved usage detail record type
description	String	The Description of the retrieved usage detail record type
unit_of_measurement	String	The Unit of measurement of the retrieved usage detail record type

Referred Objects Response Data

unit_of_measurement object response data

Name	Type	Description
id	String	The identifier of the Unit of measurement
name	String	The name of the Unit of measurement
description	String	The description of the Unit of measurement
alternative_code	String	The alternative code of the Unit of measurement

meter_reading_type object data response

Name	Type	Description
Id	String	The ID of the retrieved meter reading type
name	String	The Name of the retrieved meter reading type
alternative_code	String	The Alternative Code of the retrieved meter reading type
classification	String	The Classification of the retrieved meter reading type
description	String	The Description of the retrieved meter reading type
unit_of_measurement	String	The Unit of measurement of the retrieved meter reading type

Referred Objects Response Data

unit_of_measurement object response data

Name	Type	Description
id	String	The identifier of the Unit of measurement
name	String	The name of the Unit of measurement
description	String	The description of the Unit of measurement
alternative_code	String	The alternative code of the Unit of measurement

product_family object data response

Name	Type	Description
Id	String	The ID of the retrieved product family
name	String	The Name of the retrieved product family
code	String	The code of the retrieved product family
description	String	The Description of the retrieved product family

product_bundle_restrictions object data response

Name

Type

Description

number_of_product_types_restriction

Number

Restricts the number of product types that products can be used from

Applicable only for FLEXIBLE bundle products

number_of_product_families_restriction

Number

Restricts the number of product families that products can be used from

Applicable only for FLEXIBLE bundle products

usage_service_catalog object data response

Name	Type	Description
Id	String	The ID of the retrieved usage service catalog
name	String	The Name of the retrieved usage service catalog
alternative_code	String	The Alternative Code of the retrieved usage service catalog
description	String	The Description of the retrieved usage service catalog
effective_date	Date	The Effective Date of the retrieved usage service catalog Available from CRM.COM R14.0.0
expiration_date	Date	The Expiration Date of the retrieved usage service catalog Available from CRM.COM R14.0.0

upsells object data response

Name	Type	Description
upsell_product	String	The product which is considered as an upsell to the existing product
upsell_priority	Integer	The priority which can be used by the 3rd party system to decide the order by which the product will be displayed in relation to other upsell products

Referred Objects Response Data

product object response data

Name	Type	Description
Id	String	The ID of the product
code	String	The code of product
alternative_code	String	The alternative code of product
description	String	The description of product
priority_level	Integer	The priority level of the product Available from CRM.COM R12.3.0
global_rate	Global Rate Object	The global rate of the retrieved product Available from CRM.COM R15.0.0
product_type	Product type object	The type of the product

Referred Objects Response Data

product_type object data response

Name	Type	Description
Id	String	The ID of the retrieved product type
name	String	The Name of the retrieved product type
alternative_code	String	The Alternative Code of the retrieved product type
description	String	The Description of the retrieved product type
classification	String	The Classification of the retrieved product type which can be SERVICES or PHYSICALGOODS
service_type	String	The Service Type of the retrieved product type which can be TERMED, USAGE, ONETIME or EXPENSE
physical_good_type	String	The physical Good Type of the retrieved product type which can be TRACEABLE or NONTRACEABLE
composition_method	String	The Composition Method of the retrieved product type which can be FLAT, FLEXIBLEBUNDLE or FIXEDBUNDLE
used_for_provisioning	Boolean	The flag shows if the retrieved product type is used for provisioning
udr_type	Usage Detail Record Type	The UDR type related with the product type. This is applicable only if the product type is classified as SERVICES and the service type is set to USAGE
meter_reading_type	Meter Reading Type	The Meter Reading type related with the product type. This is applicable only for traceable physical goods Available from CRM.COM R14.0.0

Referred Objects Response Data

usage_detail_record_type object data response

Name	Type	Description
Id	String	The ID of the retrieved usage detail record type
name	String	The Name of the retrieved usage detail record type
alternative_code	String	The Alternative Code of the retrieved usage detail record type
description	String	The Description of the retrieved usage detail record type
unit_of_measurement	String	The Unit of measurement of the retrieved usage detail record type

Referred Objects Response Data

unit_of_measurement object response data

Name	Type	Description
id	String	The identifier of the Unit of measurement
name	String	The name of the Unit of measurement
description	String	The description of the Unit of measurement
alternative_code	String	The alternative code of the Unit of measurement

meter_reading_type object data response

Name	Type	Description
Id	String	The ID of the retrieved meter reading type
name	String	The Name of the retrieved meter reading type
alternative_code	String	The Alternative Code of the retrieved meter reading type
classification	String	The Classification of the retrieved meter reading type
description	String	The Description of the retrieved meter reading type
unit_of_measurement	String	The Unit of measurement of the retrieved meter reading type

Referred Objects Response Data

unit_of_measurement object response data

Name	Type	Description
id	String	The identifier of the Unit of measurement
name	String	The name of the Unit of measurement
description	String	The description of the Unit of measurement
alternative_code	String	The alternative code of the Unit of measurement

global rate object response data

Name	Type	Description
id	String	The ID of the retrieved rate
rate_model	String	The price plan rate model which can be one of the following: QUANTITYBASED QUANTITYANDPERIODBASED BILLABLEPERIODBASED DURATIONBASED FLATFEEBASED USAGEBASED From CRM.COM R17.0.0, QUANTITYANDMATURITYBASED is renamed to QUANTITYANDPERIODBASED
global_base_amount	Number	The base price of the product in the Global Price Plan
base_rate_applied_per	String	The value for 'Base Rate Applied per' Available when the rate model is 'Quantity & Quantity Based' and it is a selection between Period Period_Item
uot	String	The 'UOT' applicable for the rate Seconds Minute Hour Day Week Month Year Available for one-time services
time_period	Time Period Object	The period and unit of time for which the base amount is applicable for. This is available only on termed services rates.
uom	String	The 'UOM' applicable for the rate Available when the product type is of Usage Service Classification

Referred Objects Response Data

period object response data

Name

Type

Description

time_period_value

Number

The time period value

time_period_uot

String

The time period unit of time. The supported values are the following:

MINUTES, HOURS, DAYS, WEEKS, MONTHS, YEARS

cross_sells object data response

Name

Type

Description

cross_sell_product

String

The product which is considered as a cross-sell to the existing product.

This is bidirectional, meaning that if Product A is defined as a cross-sell to Product B, then product B will be available as a cross-sell of product A

cross_sell_priority

Integer

The priority which can be used by the 3rd party system to decide the order by which the product will be displayed in relation to other cross-sell products

Referred Objects Response Data

product object response data

Name	Type	Description
Id	String	The ID of the product
code	String	The code of product
alternative_code	String	The alternative code of product
description	String	The description of product
priority_level	Integer	The priority level of the product Available from CRM.COM R12.3.0
global_rate	Global Rate Object	The global rate of the retrieved product Available from CRM.COM R15.0.0
product_type	Product type object	The type of the product

Referred Objects Response Data

product_type object data response

Name	Type	Description
Id	String	The ID of the retrieved product type
name	String	The Name of the retrieved product type
alternative_code	String	The Alternative Code of the retrieved product type
description	String	The Description of the retrieved product type
classification	String	The Classification of the retrieved product type which can be SERVICES or PHYSICALGOODS
service_type	String	The Service Type of the retrieved product type which can be TERMED, USAGE, ONETIME or EXPENSE
physical_good_type	String	The physical Good Type of the retrieved product type which can be TRACEABLE or NONTRACEABLE
composition_method	String	The Composition Method of the retrieved product type which can be FLAT, FLEXIBLEBUNDLE or FIXEDBUNDLE
used_for_provisioning	Boolean	The flag shows if the retrieved product type is used for provisioning
udr_type	Usage Detail Record Type	The UDR type related with the product type. This is applicable only if the product type is classified as SERVICES and the service type is set to USAGE
meter_reading_type	Meter Reading Type	The Meter Reading type related with the product type. This is applicable only for traceable physical goods Available from CRM.COM R14.0.0

Referred Objects Response Data

usage_detail_record_type object data response

Name	Type	Description
Id	String	The ID of the retrieved usage detail record type
name	String	The Name of the retrieved usage detail record type
alternative_code	String	The Alternative Code of the retrieved usage detail record type
description	String	The Description of the retrieved usage detail record type
unit_of_measurement	String	The Unit of measurement of the retrieved usage detail record type

Referred Objects Response Data

unit_of_measurement object response data

Name	Type	Description
id	String	The identifier of the Unit of measurement
name	String	The name of the Unit of measurement
description	String	The description of the Unit of measurement
alternative_code	String	The alternative code of the Unit of measurement

meter_reading_type object data response

Name	Type	Description
Id	String	The ID of the retrieved meter reading type
name	String	The Name of the retrieved meter reading type
alternative_code	String	The Alternative Code of the retrieved meter reading type
classification	String	The Classification of the retrieved meter reading type
description	String	The Description of the retrieved meter reading type
unit_of_measurement	String	The Unit of measurement of the retrieved meter reading type

Referred Objects Response Data

unit_of_measurement object response data

Name	Type	Description
id	String	The identifier of the Unit of measurement
name	String	The name of the Unit of measurement
description	String	The description of the Unit of measurement
alternative_code	String	The alternative code of the Unit of measurement

global rate object response data

Name	Type	Description
id	String	The ID of the retrieved rate
rate_model	String	The price plan rate model which can be one of the following: QUANTITYBASED QUANTITYANDPERIODBASED BILLABLEPERIODBASED DURATIONBASED FLATFEEBASED USAGEBASED From CRM.COM R17.0.0, QUANTITYANDMATURITYBASED is renamed to QUANTITYANDPERIODBASED
global_base_amount	Number	The base price of the product in the Global Price Plan
base_rate_applied_per	String	The value for 'Base Rate Applied per' Available when the rate model is 'Quantity & Quantity Based' and it is a selection between Period Period_Item
uot	String	The 'UOT' applicable for the rate Seconds Minute Hour Day Week Month Year Available for one-time services
time_period	Time Period Object	The period and unit of time for which the base amount is applicable for. This is available only on termed services rates.
uom	String	The 'UOM' applicable for the rate Available when the product type is of Usage Service Classification

Referred Objects Response Data

period object response data

Name

Type

Description

time_period_value

Number

The time period value

time_period_uot

String

The time period unit of time. The supported values are the following:

MINUTES, HOURS, DAYS, WEEKS, MONTHS, YEARS

metadata attribute value response object

Name	Type	Description
id	String	The ID of the retrieved metadata field, related to the entity for which it is retrieved
key	String	The key of the retrieved metadata field, related to the entity for which it is retrieved
name	String	The name of the retrieved metadata field, related to the entity for which it is retrieved
description	String	The description of the retrieved metadata field, related to the entity for which it is retrieved
type	String	The type of the retrieved metadata field, related to the entity for which it is retrieved. Available values are: STRING INTEGER FLOAT BOOLEAN DATE
value	String	The value of the specific metadata field, related to the entity for which it is retrieved

allowed metadata attribute response object

Name	Type	Description
id	String	The ID of the retrieved metadata attribute
key	String	The key of the retrieved metadata attribute
name	String	The name of the retrieved metadata attribute
description	String	The description of the metadata attribute
type	String	The type of the retrieved metadata. Available values are: STRING INTEGER FLOAT BOOLEAN DATE
is_mandatory	Boolean	Defines whether the metadata attribute is mandatory or not
values_set	Value set Object	The values available to be set for this metadata attribute. (Configurable)
default_value	depends on the type	The default value which is applicable if a value set is defined.

Examples

Example 1

HTTP Method: POST

Request

Body

 {
	"token":"{{token}}",
	"code": "Service Product A",
	"alternative_code": "SPA",
	"description": "Product for services",
	"type_identifier": {
		"name": "Fixed Service Bundles"
	},
	"brand_identifier": {
		"alternative_code": "BT"
	},
	"family_identifier": {
		"code": "PKF"
	},
	"udf_string_1": "Service Product",
	"udf_float_2": 10.5,
	"udf_date_3": "2017-08-25T08:30:00",
	"validity_set": [
		{
			"valid_from": "2017-09-01T00:00:00",
			"valid_to": "2017-09-30T11:59:59"
		}
	],
	"categories_set": [
		{
			"category_identifier": {
				"code": "EC1"
			}
		}
	],
	"tax_rate_set": [
		{
			"rate_identifier": {
				"id": "2A8517D6169C4CB3B703E2C49D5AD1EB"
			}
		},
		{
			"rate_identifier": {
				"name": "Telephony Tax"
			}
		}
	],
	"vat_rate_set": [
		{
			"rate_identifier": {
				"id": "E92C70E2952C41E0B86EB5DE1510DB3F"
			}
		}
	],
	"components_set": [
		{
			"action": "add",
			"product": {
				"id": "30D6D1C4F7CD4CFBAFC77CBF107EEAD2"
			},
			"quantity": 10,
			"minimum_quantity": 1,
			"maximum_quantity": 100
		}
	],
	"bundle_restrictions": {
		"number_of_product_types_restriction": 20,
		"number_of_product_families_restriction": 15
	},
	"fields_set": ""
}

Response

 {
    "data": {
        "code": "Service Product A",
        "alternative_code": "SPA",
        "log_information": {
            "created_by_unit": {
                "alternative_code": "adminunit",
                "group_name": "Main Group",
                "community_name": "Community",
                "name": "Admin Unit",
                "description": "admin unit",
                "id": "1"
            },
            "updated_by_unit": {
                "alternative_code": "adminunit",
                "group_name": "Main Group",
                "community_name": "Community",
                "name": "Admin Unit",
                "description": "admin unit",
                "id": "1"
            },
            "created_date": "2017-08-24T11:52:57",
            "updated_date": "2017-08-24T11:52:58",
            "updated_by_user": {
                "person_name": "CRM COM",
                "id": "1",
                "username": "MPAdministrator"
            },
            "created_by_user": {
                "person_name": "CRM COM",
                "id": "1",
                "username": "MPAdministrator"
            }
        },
        "components_set": [
            {
                "product": {
                    "code": "PPT_A",
                    "product_type": {
                        "service_type": "TERMED",
                        "used_for_provisioning": true,
                        "alternative_code": "AO",
                        "udr_type": null,
                        "composition_method": "FLAT",
                        "name": "Add-ons",
                        "description": "Additional products",
                        "id": "E2324486B2454B56B054ED8129E3A9C0",
                        "classification": "SERVICES",
                        "physical_good_type": null
                    },
                    "alternative_code": "P",
                    "description": "PPT_A",
                    "id": "30D6D1C4F7CD4CFBAFC77CBF107EEAD2"
                },
                "quantity": 10,
                "max_quantity": 100,
                "min_quantity": 1,
                "id": "586AC0C800C047B9827FC385085A6EA9"
            }
        ],
        "price_plans_set": [],
        "description": "Product for services",
        "udf_date_2": null,
        "type": {
            "service_type": "TERMED",
            "used_for_provisioning": false,
            "alternative_code": "FSB_1",
            "udr_type": null,
            "composition_method": "FIXEDBUNDLE",
            "name": "Fixed Service Bundles",
            "description": null,
            "id": "B6B89600B6B141E9A01F47FD547CB740",
            "classification": "SERVICES",
            "physical_good_type": null
        },
        "udf_date_1": null,
        "udf_date_4": null,
        "udf_date_3": "2017-08-25T08:30:00",
        "udf_float_3": null,
        "udf_float_4": null,
        "udf_string_15": null,
        "categories_set": [
            {
                "id": "B30B2F6F77B440F9AACC828F832FEA36",
                "category": {
                    "code": "EC1",
                    "name": "Expense Category",
                    "description": null,
                    "id": "8320A513FBF34B75AD250E844B509009"
                }
            }
        ],
        "udf_string_16": null,
        "udf_string_13": null,
        "validity_set": [
            {
                "valid_to": "2017-09-30T11:59:59",
                "valid_from": "2017-09-01T00:00:00",
                "id": "B2F96A7F7ECE4868966FD71B678562A2"
            }
        ],
        "udf_string_14": null,
        "udf_string_11": null,
        "udf_string_12": null,
        "bundle_restrictions": [
            {
                "number_of_product_families_restriction": 15,
                "number_of_product_types_restriction": 20
            }
        ],
        "id": "C27AC0553F2E4CD6BC80FFD1315ECA57",
        "udf_string_10": null,
        "udf_float_1": null,
        "udf_float_2": 10.5,
        "brand": {
            "alternative_code": "BT",
            "name": "brand test",
            "description": null,
            "id": "CA43B8302B0D43A49A934099D039656B"
        },
        "udf_string_2": null,
        "udf_string_3": null,
        "udf_string_4": null,
        "udf_string_5": null,
        "udf_string_1": "Service Product",
        "udf_string_6": null,
        "family": {
            "code": "PKF",
            "name": "PK_Family",
            "description": null,
            "id": "3E91CC57B69240FBB367C1BD534BF190"
        },
        "udf_string_7": null,
        "udf_string_8": null,
        "usage_service_catalogs_set": [],
        "tax_rate_set": [
            {
                "alternative_code": "TT",
                "name": "Telephony Tax",
                "description": null,
                "id": "DA6DD47A53DC4CBB8D0EEF698B08E94A"
            },
            {
                "alternative_code": "T",
                "name": "Test",
                "description": null,
                "id": "2A8517D6169C4CB3B703E2C49D5AD1EB"
            }
        ],
        "vat_rate_set": [
            {
                "alternative_code": "U",
                "name": "Usage",
                "description": null,
                "id": "E92C70E2952C41E0B86EB5DE1510DB3F"
            }
        ],
        "udf_string_9": null
    },
    "status": {
        "code": "OK",
        "description": "",
        "message": ""
    }
}

Example 2

HTTP Method: POST

Request

Body

 {
	"token":"{{token}}",
	"code": "Service Product B",
	"alternative_code": "SPB",
	"description": "Another product for services",
	"type_identifier": {
		"id": "EE0AA3102B414622A57926EDD0D624FF"
	},
	"validity_set": [
		{
			"valid_from": "2017-08-01T00:00:00"
		}
	],
	"tax_rate_set": [
		{
			"rate_identifier": {
				"name": "Telephony Tax"
			}
		}
	],
	"vat_rate_set": [
		{
			"rate_identifier": {
				"id": "E92C70E2952C41E0B86EB5DE1510DB3F"
			}
		}
	],
	"fields_set": "id,code,alternative_code,log_information,tax_rate_set,vat_rate_set,validity_set"
}

Response

 {
    "data": {
        "code": "Service Product B",
        "alternative_code": "SPB",
        "log_information": {
            "created_by_unit": {
                "alternative_code": "adminunit",
                "group_name": "Main Group",
                "community_name": "Community",
                "name": "Admin Unit",
                "description": "admin unit",
                "id": "1"
            },
            "updated_by_unit": {
                "alternative_code": "adminunit",
                "group_name": "Main Group",
                "community_name": "Community",
                "name": "Admin Unit",
                "description": "admin unit",
                "id": "1"
            },
            "created_date": "2017-08-24T12:03:52",
            "updated_date": "2017-08-24T12:03:52",
            "updated_by_user": {
                "person_name": "CRM COM",
                "id": "1",
                "username": "MPAdministrator"
            },
            "created_by_user": {
                "person_name": "CRM COM",
                "id": "1",
                "username": "MPAdministrator"
            }
        },
        "validity_set": [
            {
                "valid_to": null,
                "valid_from": "2017-08-01T00:00:00",
                "id": "2F2F5FFF38E74EE58C8C6DA3DA74B06F"
            }
        ],
        "id": "4AEDA92F9A9C49D1AAB24DD9B603B51A",
        "tax_rate_set": [
            {
                "alternative_code": "TT",
                "name": "Telephony Tax",
                "description": null,
                "id": "DA6DD47A53DC4CBB8D0EEF698B08E94A"
            }
        ],
        "vat_rate_set": [
            {
                "alternative_code": "U",
                "name": "Usage",
                "description": null,
                "id": "E92C70E2952C41E0B86EB5DE1510DB3F"
            }
        ]
    },
    "status": {
        "code": "OK",
        "description": "",
        "message": ""
    }
}