Skip to end of banner
Go to start of banner

price_plan_rates_complete

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 19 Next »

Name

Type

Description

codeStringThe code of the retrieved price plan rate
rate_modelString

The rate model of the retrieved price plan rate. Available values are:

  • FLATRATEQUANTITYBASED
  • TIEREDRATEQUANTITYBASED
  • FLATRATEMATURITYBASED
  • TIEREDRATEMATURITYBASED
  • FLATRATEDURATIONBASED
  • TIEREDRATEDURATIONBASED
  • FLATRATEQUANTITYANDMATURITYBASED
  • TIEREDRATEQUANTITYANDMATURITYBASED
  • FLATRATE

FLATRATEMATURITYBASED, FLATRATEQUANTITYANDMATURITYBASED and TIEREDRATEQUANTITYANDMATURITYBASED are available from CRM.COM R14.0.0

base_amountNumberThe base rate that is applied if not tiered rates are applied
effective_starting_fromSting

The date option that determines when a recurring charges will become active. Applicable only for termed services. The applicable values are: BINDINGSTARTDATE, SERVICEEFFECTIVEDATE, AGREEMENTDATE and LATESTRATEDUPTODATE

Available from CRM.COM R12.0.0

uotSting

The unit of time that can be used to measure time. This is mandatory information only for termed services.The applicable values are:

  • SECONDS
  • MINUTES
  • HOUR
  • DAY
  • WEEK
  • MONTH
  • YEAR

From CRM.COM R14.0.0 the time period object should be used, although the uot will still be available.

time_periodTime Period Object

The period and unit of time used to calculate the rates for termed services. This is applicable only on termed services rates. Only days, weeks, months and years are applicable for termed services rates.

Available from CRM.COM R14.0.0

price_planPrice Plan ObjectThe base price plan related with the retrieved price plan. This information is available only if the retrieved price plan is a conditional price plan
productProduct ObjectThe physical good or service whose price plan rate is returned as a result.
product_bundleProduct ObjectThe product bundle related with the selected product whose price plan rate is returned as a result.. This information is applicable only if the specified product is used as a product component belonging to a product having a type classified as flexible bundle product.
tiered_rates_setSet of Tiered Rates Objects

A list of tiered rates related to the specified product. This information is applicable only for tiered price plan rate models.

From CRM.COM R14.0.0 the termed_services_rates_set should be used for termed services. The tiered_rates_set will still be available but it will not be applicable for termed services following the FLATRATEQUANTITYANDMATURITYBASED and TIEREDRATEQUANTITYANDMATURITYBASED rate models

termed_services_tiered_rates_setSet of Termed Services Tiered Rates Objects

A list of tiered rates related to the specified termed service. This information is applicable only for tiered price plan rate models defined for termed services

Available from CRM.COM R14.0.0

additional_price_plan_ratesSet of Additional Price Plan Rates Objects

A list of base rates in various currencies for the same product within the specified price plan.

Available from CRM.COM R14.2.0

additional_price_plan_tiered_ratesSet of Additional Price Plan Tiered Rates Objects

A list of tiered rates in various currencies for the same product within the specified price plan.

Available from CRM.COM R14.2.0


Referred Objects Response Data

 period object response data

Name

Type

Description

time_period_valueNumber

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

 price_plan object data response
NameType Description
IdStringThe ID of the retrieved price plan
nameStringThe Name of the retrieved price plan
codeStringThe Code of the retrieved price plan
descriptionStringThe Description of the retrieved price plan
typeStringThe Type of the retrieved price plan which can be BASE or CONDITIONAL
effective_date DateThe Effective Date of the retrieved price plan
expiration_date Date

The Expiration Date of the retrieved price plan

currencyCurrency 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_symbolStringThe prefix symbol for the specified currency

suffix_symbol

StringThe suffix symbol for the specified currency
life_cycle_stateString

The life cycle state for the specified currency, which can be EFFECTIVE or NOT EFFECTIVE

Available from CRM.COM R14.0.0

integer_part_nameStringThe integer part name for the specified currency
decimal_part_nameStringThe decimal part name for the specified currency

 product object response data
Name
Type
Description
IdStringThe ID of the product
codeStringThe code of product

alternative_code

String

The alternative code of product

description

String

The description of product

priority_levelInteger

The priority level of the product

Available from CRM.COM R12.3.0

global_rateGlobal Rate Object

The global rate of the retrieved product

Available from CRM.COM R15.0.0

product_typeProduct type objectThe type of the product

Referred Objects Response Data

 product_type object data response
NameType Description
IdStringThe ID of the retrieved product type
nameStringThe Name of the retrieved product type
alternative_codeStringThe Alternative Code of the retrieved product type
descriptionStringThe Description of the retrieved product type
classificationStringThe Classification of the retrieved product type which can be SERVICES or PHYSICALGOODS
service_typeStringThe Service Type of the retrieved product type which can be TERMED, USAGE, ONETIME or EXPENSE
physical_good_typeStringThe physical Good Type of the retrieved product type which can be TRACEABLE or NONTRACEABLE
composition_methodStringThe Composition Method of the retrieved product type which can be FLAT, FLEXIBLEBUNDLE or FIXEDBUNDLE
used_for_provisioningBooleanThe flag shows if the retrieved product type is used for provisioning
udr_typeUsage Detail Record TypeThe 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_typeMeter 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
NameType Description
IdStringThe ID of the retrieved usage detail record type
nameStringThe Name of the retrieved usage detail record type
alternative_codeStringThe Alternative Code of the retrieved usage detail record type
descriptionStringThe Description of the retrieved usage detail record type
unit_of_measurementStringThe Unit of measurement of the retrieved usage detail record type

Referred Objects Response Data

 unit_of_measurement object response data

Name

Type

Description

idStringThe 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_codeStringThe alternative code of the Unit of measurement

 

 meter_reading_type object data response
NameType Description
IdStringThe ID of the retrieved meter reading type
nameStringThe Name of the retrieved meter reading type
alternative_codeStringThe Alternative Code of the retrieved meter reading type
classificationStringThe Classification of the retrieved meter reading type
descriptionStringThe Description of the retrieved meter reading type
unit_of_measurementStringThe Unit of measurement of the retrieved meter reading type

Referred Objects Response Data

 unit_of_measurement object response data

Name

Type

Description

idStringThe 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_codeStringThe 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_amountNumber

The base price of the product in the Global Price Plan

base_rate_applied_perString

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
uotString

The 'UOT' applicable for the rate

  • Seconds
  • Minute
  • Hour
  • Day
  • Week
  • Month
  • Year

Available for one-time services

time_periodTime Period Object

 The period and unit of time for which the base amount is applicable for. This is available only on termed services rates.

uomString

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_valueNumber

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

 tiered rates object response data
Name
Type
Description
tier_levelStringThe level of the tiered rate
tier_rate_fromNumberThe tiered rate's number from which the tiered amount is applicable (inclusive)
tier_rate_toNumberThe tiered rate's number until which the tiered amount is applicable (inclusive). This information is optional.
tier_rate_to_optionStringThe option that defines how the tier rate's to will be used. The available options are SPECIFIC_NUMBER, UNLIMITED and BINDING_END_DATE. If the SPECIFIC_NUMBER option is set, then the tier rate to value is also returned.
tiered_amountNumberThe tiered rate amount

 termed services tiered rates object response data
Name
Type
Description
levelStringThe level of the tiered rate
from_maturity_periodNumberThe beginning of the maturity period, inclusive, that will provide the specified rate
to_maturity_periodNumberThe end of the maturity period (inclusive) that will provide the specified rate
from_quantityNumberThe minimum quantity (number of times that the service is distributed), inclusive, that will provide the specified rate
to_quantityNumberThe maximum quantity (number of times that the service is distributed), inclusive, that will provide the specified rate
amountNumberThe tiered rate amount provided if the maturity period and the quantity (number of times that the service is distributed) are within the ranges specified above

 additional currency rates object response data
Name
Type
Description
base_amountNumberThe base amount of the additional currency
currencyCurrency ObjectThe Currency in which the base amount is specified

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_symbolStringThe prefix symbol for the specified currency

suffix_symbol

StringThe suffix symbol for the specified currency
life_cycle_stateString

The life cycle state for the specified currency, which can be EFFECTIVE or NOT EFFECTIVE

Available from CRM.COM R14.0.0

integer_part_nameStringThe integer part name for the specified currency
decimal_part_nameStringThe decimal part name for the specified currency

 additional currency rates object response data
Name
Type
Description
tiered_amountNumberThe tiered amount of the additional currency
currencyCurrency ObjectThe Currency in which the tiered amount is specified

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_symbolStringThe prefix symbol for the specified currency

suffix_symbol

StringThe suffix symbol for the specified currency
life_cycle_stateString

The life cycle state for the specified currency, which can be EFFECTIVE or NOT EFFECTIVE

Available from CRM.COM R14.0.0

integer_part_nameStringThe integer part name for the specified currency
decimal_part_nameStringThe decimal part name for the specified currency

 

  • No labels