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

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

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

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

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

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 through the related usage service catalog. 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 through the related usage service catalog. 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 through the related usage service catalog. 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 through the related usage service catalog

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 through the related usage service catalog. In that case it is mandatory to set this information.

Available from CRM.COM R12.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.

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

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

  • No labels