Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Tip

Available from CRM.COM R8.0.0

Table of Contents
maxLevel2

...

Name

Type

Description

token

String

The token retrieved from the login method

usage_service_catalog_identifier

(mandatory)

Usage Service Catalog Identifier

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

Include Page
V4:usage_service_catalog_identifier
V4:usage_service_catalog_identifier

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

...

Name

Type

Description

token

String

The token retrieved from the login method

life_cycle_state

(optional)

StringIf specified then only usage service catalogs having a life cycle state equal to the specified value will be retrieved. The supported values are DRAFT, EFFECTIVE, NOT_EFFECTIVE or CANCELLED

valid_as_of_date

(optional)

DateIf specified then only usage service catalogs which are valid on that date will be retrieved.

provisioning_provider_identifier

(optional)

Provisioning Provider Identifier

If specified then only usage service catalogs related with the specified provisioning provider will be retrieved. The allowed provisioning provider identifier fields are the following:

Include Page
V4:provisioning_provider_identifier
V4:provisioning_provider_identifier

accounts_receivable_identifier

(optional)

Accounts Receivable Identifier

If specified then the only usage service catalogs which can be provided to the specified accounts receivable will be retrieved. The allowed accounts receivable identifier fields are the following:

Include Page
V4:accounts_receivable_identifier
V4:accounts_receivable_identifier

subscription_identifier

(optional)

Subscription Identifier

If specified then the only usage service catalogs which can be provided to the specified subscription will be retrieved. The allowed subscription identifier fields are the following:

Include Page
V4:subscription_identifier
V4:subscription_identifier

termed_service_identifier

(optional)

Product Identifier

If specified then the only usage service catalogs which can be provided to the specified termed service will be retrieved. The allowed termed service identifier fields are the following:

Include Page
V4:product_identifier
V4:product_identifier

group_identifier

(optional)

Group Identifier

The identifier of the group that will be using the usage service catalog. The group is filtered against the usage service catalog's allowed organisational units. The allowed group identifier fields are the following:

Include Page
V4:group_identifier
V4:group_identifier

unit_identifier

(optional)

Unit Identifier

The identifier of the unit that will be using the usage service catalog. The unit is filtered against the usage service catalog's allowed organisational units. The allowed unit identifier fields are the following:

Include Page
V4:unit_identifier
V4:unit_identifier

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

...

Name

Type

Description

token

String

The token retrieved from the login method

valid_as_of_date

(mandatory)

DateIf specified then only usage services included in usage service catalogs which are valid on that date will be retrieved.

usage_service_catalog_identifier

(optional)

Usage Service Catalog Identifier

If specified then only usage services included in that usage service catalogs will be retrieved. The allowed usage service catalog identifier fields are the following:

Include Page
V4:usage_service_catalog_identifier
V4:usage_service_catalog_identifier

provisioning_provider_identifier

(optional)

Provisioning Provider Identifier

If specified then only usage services included in usage service catalogs related with the specified provisioning provider will be retrieved. The allowed provisioning provider identifier fields are the following:

Include Page
V4:provisioning_provider_identifier
V4:provisioning_provider_identifier

accounts_receivable_identifier

(optional)

Accounts Receivable Identifier

If specified then the only usage services included in usage service catalogs which can be provided to the specified accounts receivable will be retrieved. The allowed accounts receivable identifier fields are the following:

Include Page
V4:accounts_receivable_identifier
V4:accounts_receivable_identifier

subscription_identifier

(optional)

Subscription Identifier

If specified then the only usage services included in usage service catalogs which can be provided to the specified subscription will be retrieved. The allowed subscription identifier fields are the following:

Include Page
V4:subscription_identifier
V4:subscription_identifier

termed_service_identifier

(optional)

Product Identifier

If specified then the only usage services included in usage service catalogs which can be provided to the specified termed service will be retrieved. The allowed termed service identifier fields are the following:

Include Page
V4:product_identifier
V4:product_identifier

group_identifier

(optional)

Group Identifier

The identifier of the group that will be using the usage services. The group is filtered against the usage service catalog's allowed organisational units. The allowed group identifier fields are the following:

Include Page
V4:group_identifier
V4:group_identifier

unit_identifier

(optional)

Unit Identifier

The identifier of the unit that will be using the usage services. The unit is filtered against the usage service catalog's allowed organisational units. The allowed unit identifier fields are the following:

Include Page
V4:unit_identifier
V4:unit_identifier

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

...

Name

Type

Description

token

String

The token retrieved from the login method

valid_as_of_date

(mandatory)

DateIf specified then only usage services included in usage service catalogs which are valid on that date will be retrieved.

usage_service_identifier

(semi-optional)

Usage Service Identifier

If specified then only usage services rates related with the specified usage service will be retrieved. The allowed usage service identifier fields are the following:

Include Page
V4:product_identifier
V4:product_identifier

usage_service_catalog_identifier

(semi-optional)

Usage Service Catalog Identifier

If specified then only usage services included in that usage service catalogs will be retrieved. The allowed usage service catalog identifier fields are the following:

Include Page
V4:usage_service_catalog_identifier
V4:usage_service_catalog_identifier

provisioning_provider_identifier

(optional)

Provisioning Provider Identifier

If specified then only usage services included in usage service catalogs related with the specified provisioning provider will be retrieved. The allowed provisioning provider identifier fields are the following:

Include Page
V4:provisioning_provider_identifier
V4:provisioning_provider_identifier

accounts_receivable_identifier

(optional)

Accounts Receivable Identifier

If specified then the only usage services included in usage service catalogs which can be provided to the specified accounts receivable will be retrieved. The allowed accounts receivable identifier fields are the following:

Include Page
V4:accounts_receivable_identifier
V4:accounts_receivable_identifier

subscription_identifier

(optional)

Subscription Identifier

If specified then the only usage services included in usage service catalogs which can be provided to the specified subscription will be retrieved. The allowed subscription identifier fields are the following:

Include Page
V4:subscription_identifier
V4:subscription_identifier

termed_service_identifier

(optional)

Product Identifier

If specified then the only usage services included in usage service catalogs which can be provided to the specified termed service will be retrieved. The allowed termed service identifier fields are the following:

Include Page
V4:product_identifier
V4:product_identifier

group_identifier

(optional)

Group Identifier

The identifier of the group that will be using the usage services. The group is filtered against the usage service catalog's allowed organisational units. The allowed group identifier fields are the following:

Include Page
V4:group_identifier
V4:group_identifier

unit_identifier

(optional)

Unit Identifier

The identifier of the unit that will be using the usage services. The unit is filtered against the usage service catalog's allowed organisational units. The allowed unit identifier fields are the following:

Include Page
V4:unit_identifier
V4:unit_identifier

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

...

Parameters

NameType Description

name

(mandatory)

StringThe Name of the usage service catalog

alternative_code

(mandatory)

StringThe Alternative Code of the usage service catalog. If not specified then it is generated automatically based on the specified name

description

(optional)

StringThe Description of the usage service catalog
termed_service_requirementsString

Defines the settings related to whether a termed service will be required when adding a Usage Service on a Subscription. Applicable values are:

  • REQUIRES_EFFECTIVE_TERMED_SERVICE
  • REQUIRES_EFFECTIVE_OR_NOT_EFFECTIVE_TERMED_SERVICE
  • DOES_NOT_REQUIRE_TERMED_SERVICE
Tip

Available from R13.0.0

create_as_draft

(optional)

Boolean

If set to true then the usage service catalog will be created as draft. If set to false or not specified at all, then the usage service catalog will be created as effective

provisioning_provider_identifier

(optional)

Provisioning Provider Identifier

The provisioning provider related with the usage service catalog that will be created. The allowed provisioning provider identifier fields are the following:

Include Page
V4:provisioning_provider_identifier
V4:provisioning_provider_identifier

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

validity_set

(optional)

Set of Usage Service Catalog Validity ObjectsThe  time periods during which the usage service catalog will be available to be used. If not specified then the usage service catalog will be always be available

usage_services_set

(mandatory)

Set of Usage Service Catalog Usage ServicesThe usage services offered through the usage service catalog and their rates. At least one usage service should be specified. Each usage service can be included in a usage service catalog just once. Only products classified as usage services can be specified.

...

NameType Description

usage_service_catalog_identifier

(mandatory)

Usage Service Catalog Identifier

The usage service catalog that will be updated. The allowed usage service catalog identifier fields are the following:

Include Page
V4:usage_service_catalog_identifier
V4:usage_service_catalog_identifier

name

(optional)

StringThe Name of the usage service catalog

alternative_code

(optional)

StringThe Alternative Code of the usage service catalog. If not specified then it is generated automatically based on the specified name

description

(optional)

StringThe Description of the usage service catalog

update_as_draft

(optional and applicable on conditions)

Boolean

If set to true then the usage service catalog will be updated as draft. If set to false or not specified at all, then the usage service catalog will be updated as effective. This is applicable only if the usage service catalog that will be updated is in draft life cycle state

provisioning_provider_identifier

(optional)

Provisioning Provider Identifier

The provisioning provider related with the usage service catalog that will be updated. The allowed provisioning provider identifier fields are the following:

Include Page
V4:provisioning_provider_identifier
V4:provisioning_provider_identifier

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

validity_set

(optional)

Set of Usage Service Catalog Validity Objects

The  time periods during which the usage service catalog will be available to be used. If not specified then the usage service catalog will be always be available

Include Page
V4:Web API - Updating Sets
V4:Web API - Updating Sets

usage_services_set

(mandatory)

Set of Usage Service Catalog Usage Services

The usage services offered through the usage service catalog and their rates. At least one usage service should be specified. Each usage service can be included in a usage service catalog just once. Only products classified as usage services can be specified.

Include Page
V4:Web API - Updating Sets
V4:Web API - Updating Sets

Note that usage services already included in a usage service catalog can be removed only if the usage service catalog is still draft, or if the usage service catalog is effective or not effective and there are no usage subscription services which are posted, billable and still not billed

...

Name

Type

Description

token

String

The token retrieved from the login method

usage_service_catalog_identifier

(mandatory)

Usage Service Catalog Identifier

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

Include Page
V4:usage_service_catalog_identifier
V4:usage_service_catalog_identifier

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

...

Name

Type

Description

token

String

The token retrieved from the login method

usage_service_catalog_identifier

(mandatory)

Usage Service Catalog Identifier

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

Include Page
V4:usage_service_catalog_identifier
V4:usage_service_catalog_identifier

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

...

Name

Type

Description

token

String

The token retrieved from the login method

usage_service_catalog_identifier

(mandatory)

Usage Service Catalog Identifier

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

Include Page
V4:usage_service_catalog_identifier
V4:usage_service_catalog_identifier

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

...