Skip to end of banner
Go to start of banner

subscription_usage_detail_record_parameters

Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 31 Next »

 usage_detail_record parameter object data

Name

Type

Description

product_identifier

(mandatory)

Product identifier

The actual product that was used. 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

Only products classified as usage services can be specified in this parameter

source_system_identifier

(optional)

Usage Detail Record Source System identifier

The source system of the usage detail record. The allowed usage detail source system identifier fields are the following:

Name

Type

Description

id

(semi-optional)

String

The ID of the usage detail record source system

name

(semi-optional)

String

The name of the usage detail record source system

alternative_code

(semi-optional)

String

The alternative code of  the usage detail record source system

Deprecated from CRM.COM R15.0.0

type_identifier

(mandatory)

 Usage Detail Record Type identifier

The type of the usage detail record. The allowed usage detail type identifier fields are the following:

Name

Type

Description

id

(semi-optional)

String

The ID of the usage detail record type

name

(semi-optional)

String

The name of the usage detail record type

alternative_code

(semi-optional)

String

The alternative code of  the usage detail record type

Starting from CRM.COM R13.0.0 this information will be deprecated. The type will be set automatically based on the product type of the usage service specified

usage_service_catalog_identifier

(mandatory on conditions)

Usage Service Catalog identifier

The identifier of the related usage service catalog. The allowed usage service catalog identifier fields are the following:

Name

Type

Description

id

(semi-optional)

String

The ID of the usage service catalog

name

(semi-optional)

String

The name of the usage service catalog

alternative_code

(semi-optional)

String

The alternative code of  the usage service catalog

This information is mandatory unless the specified product belongs to only one usage service catalog. In that case the usage service catalog is set automatically.

From CRM.COM R13.1.0, this information is optional even if the specified product belongs to more than one usage service catalogs but only as long as these catalogs have distinct conditions

From CRM.COM R14.0.0, if the requested usage service is included in the agreed pricing agreement (usage service catalog) of an Accounts Receivable, then the specified usage service catalog should be the agreed one. If not specified, then the agreed catalog will be used by default. This applies for adding usage services for Accounts Receivables that are members of an Account Group. If no such pricing agreement exists, the process will remain as is


device_identifier

(optional)

Usage Detail Record Device identifier

The identifier of the related usage detail record device. The allowed usage detail record device identifier fields are the following:

Name

Type

Description

id

(semi-optional)

String

The ID of the usage detail record device

name

(semi-optional)

String

The name of the usage detail record device

alternative_code

(semi-optional)

String

The alternative code of  the usage detail record device

Deprecated from CRM.COM R15.0.0

usage_method_identifier

(optional)

Usage Detail Record Usage Method identifier

The identifier of the related usage detail record usage method. The allowed usage detail record usage method identifier fields are the following:

Name

Type

Description

id

(semi-optional)

String

The ID of the usage detail record usage_method

name

(semi-optional)

String

The name of the usage detail record usage_method

alternative_code

(semi-optional)

String

The alternative code of  the usage detail record usage_method

Deprecated from CRM.COM R15.0.0

source_category_identifier

(optional)

Usage Detail Record Source Category identifier

The identifier of the related usage detail record source category. The allowed usage detail record source category identifier fields are the following:

Name

Type

Description

id

(semi-optional)

String

The ID of the usage detail record source category

name

(semi-optional)

String

The name of the usage detail record source category

code

(semi-optional)

String

The code of  the usage detail record source category

Deprecated from CRM.COM R15.0.0

destination_category_identifier

(optional)

Usage Detail Record Destination Category identifier

The identifier of the related usage detail record destination category. The allowed usage detail record destination category identifier fields are the following:

Name

Type

Description

id

(semi-optional)

String

The ID of the usage detail record destination category

name

(semi-optional)

String

The name of the usage detail record destination category

code

(semi-optional)

String

The code of  the usage detail record destination category

Deprecated from CRM.COM R15.0.0

billing_effective_date

(optional)

DateThe usage detail record billing effective date

from_date

(mandatory based on conditions)

Date

The date that the usage of the service started. Not mandatory if the usage service has a Unit of measurement

For releases prior to CRM.COM R13.0.0 this information is always mandatory

to_date

(mandatory based on conditions)

Number

The date that the usage of the service stopped. Not mandatory if the usage service has a Unit of measurement

For releases prior to CRM.COM R13.0.0 this information is always mandatory


usage_amount

(mandatory on conditions)

Number

The usage detail record total usage amount. This is applicable and mandatory only if the usage service is measurable, otherwise it is automatically set to 1

For releases prior to CRM.COM R13.0.0 this information is always mandatory

total_amount

(mandatory and applicable on conditions)

Number

The total amount that the usage detail record will be rated for. This information can be set only if the usage detail record is defined as pre-rated. In that case it is mandatory to set this information.

Available from CRM.COM R12.0.0

vat_amount

(mandatory and applicable on conditions)

Number

The VAT amount that will be applied on the usage detail record. This information can be set only if the usage detail record is defined as pre-rated. In that case it is mandatory to set this information.

Available from CRM.COM R12.0.0

tax_amount

(optional and applicable on conditions)

 

The total Tax amount that will be applied on the usage detail record. This information can be set only if the usage detail record is defined as pre-rated. In that case it is mandatory to set this information.

Available from CRM.COM R12.0.0


discount_amount

(optional and applicable on conditions)

Number

The discount amount that will be applied on the usage detail record. This information can be set only if the usage detail record is defined as pre-rated

Available from CRM.COM R12.0.0

rating_date

(mandatory and applicable on conditions)

Date

The date that the rating was applied on the usage detail record. This information can be set only if the usage detail record is defined as pre-rated. In that case it is mandatory to set this information.

Available from CRM.COM R12.0.0

rated

(optional)

Boolean

It defines if the usage service is already rated through a 3rd party system or not. It the value is true then it means that the service is already rated. It the value is false then it means that the service will be rated by CRM.COM

Available from CRM.COM R15.0.0

apply_additional_discount

(optional)

Boolean

 It defines if additional discount will be applicable on the already rated usage service. This option is applicable only if the usage service is classified as already rated

Available from CRM.COM R15.0.0

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

provisioning_distributor_identifier

(mandatory on conditions)

Provisioning Distributor Identifier

The identifier of the provisioning distributor that will be used to distribute the product. The allowed provisioning distributor identifier fields are the following:

Name

Type

Description

id

(semi-optional)

String

The ID of the provisioning distributor

name

(semi-optional)

String

The name of the provisioning distributor

alternative_code

(semi-optional)

String

The alternative code of  the provisioning distributor

This information is mandatory unless the specified subscription service is distributed to only one provisioning distributor. In that case the provisioning distributor is set automatically.

Deprecated from CRM.COM R15.0.0

installed_item_identifier

(mandatory on conditions)

Installed Item Identifier

The identifier of the installed item on which the service will be consumed. The allowed identifier fields are the following

Name

Type

Description

id

(semi-optional)

String

The ID of the installed item

serial_number

(semi-optional)

String

The serial number of the installed item

alternative_code

(semi-optional)

String

The alternative code of  a installed item

This parameter is mandatory if the related Usage Service Catalog requires an Installed Item to be specified when adding a Usage Service

Available from CRM.COM R14.0.0

subscription_service

(mandatory)

Existing Subscription service Object

An existing subscription service, classified as termed service that will be related with the usage detail record

This information is mandatory if the usage service's related usage service catalog set the "Termed Service Requirements" to any of the following:

  • Requires an effective termed service OR
  • Requires a termed service (effective or not effective)

If it is mandatory to specify this information then if only one termed service can be used to allow the addition of usage detail record then this information will be set automatically

For releases prior to CRM.COM R13.0.0 this information is always mandatory and from CRM.COM R13.0.0 this information is mandatory on conditions

From CRM.COM R14.0.0 this information is always mandatory

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 udr

Available from CRM.COM R15.0.0

You can only add existing metadata attributes which are already provided through the UDR Type

Referred Parameter Objects Data

 existing subscription service object parameter data
Name
Type
Description

subscription_service_id

(semi-optional)

StringThe ID of the subscription service
service_identifier

(semi-optional)

Service identifier  

The identifier of the service related with the subscription service that belongs to the subscription specified in the parameters. Only products classified as services are retrieved. The allowed service 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

 allowed metadata attribute parameter data

Name

Type

Description

allowed_metadata_identifierString

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_mandatoryBooleanDefine whether it is mandatory to provide a value for this attribute when creating entities using this entity/entity type.

  • No labels