billing_terms_short

 subscription_billing_terms object response data

Name

Type

Description

id

String

The ID of the retrieved billing terms

life_cycle_stateString

The life cycle state of the retrieved billing terms which can be EFFECTIVE or TERMINATED

is_auto_renewedBoolean

Indicates whether the subscription will be auto-renewed at the end of its billing cycle or not.

Available from CRM.COM R15.0.0

next_renewal_dateDate

Defines the date on which the subscription's billing terms will be auto-renewed. Applicable only if customer opts in to auto-renewals. The date is automatically calculated based on the subscription's billing cycle.

Available from CRM.COM R18.0.0

expires_onDate

Defines the date on which the subscription's billing terms will be expired (i.e. it will not be automatically renewed). Applicable only if customer opts out from auto-renewals.

Available from CRM.COM R18.0.0

billing_cycle_dayNumberThe billing cycle day of the retrieved billing terms. Billing cycle day is used to specify up to which day of the month a subscription should be billed
billing_cycle_last_day_of_monthBoolean

Indicates that the billing term's billing cycle day is the last day of each month. Applicable only when the billing method is Anniversary. If set to Yes, then the billing_cycle_day is not applicable

Available from CRM.COM R12.0.0

agreement_dateDateThe agreement date of the retrieved billing terms. Billing terms agreement date is used to log the date that the billing terms were agreed and signed by the customer
allowed_cancel_dateDate

The allowed cancel date of the retrieved billing terms. Allowed cancel date is used to define the date that the billable entity can be churned or terminated.

Deprecated from CRM.COM R15.0.0

effective_dateDateThe effective date of the retrieved billing terms
expiration_dateDateThe expiration date of the retrieved billing terms. The expiration date is set when billing terms are amended and a new version of billing terms is in effect. The old version of billing terms (i.e. the replaced one) is expired and no longer valid.
concurrent_usage_based_pricingConcurrent usage based pricing objectConcurrent usage based pricing is used to apply price plan rates based on the number of concurrent usage of the services or the installed items that will be billed, and a rate percentage which is agreed between the customer and the company providing those service
billing_term_schemeBilling term scheme objectThe billing term scheme of the retrieved billing terms
price_planPrice Plan Object

The price plan of the retrieved billing terms

Deprecated from CRM.COM R15.0.0

billing_frequencyBilling Frequency ObjectThe billing frequency of the retrieved billing terms. Billing Frequencies are used to denote how often a subscription should be billed.
binding_informationBinding Information ObjectThe binding information of the retrieved billing terms. Binding information is used to determine if a customer is contractually committed to receive services from the service provider for a fixed period of time.

Referred Objects Response Data

 concurrent_usage_based_pricing object response data

Name

Type

Description

concurrent_usage

Number

Defines the concurrent usage of services which will be billed based on the specified billing terms

Deprecated from CRM.COM R15.0.0

rate_percentage

Number

Defines the rate percentage that should be applied on all services which will be billed based on the specified billing terms

Deprecated from CRM.COM R15.0.0

number_of_installed_itemsNumber

The agreed number of installed items that will be concurrently consuming the subscription's services

Available from CRM.COM R15.0.0

 concurrent_usage_billing_methodString

Defines how the subscriber will be billed because of the concurrent usage of the subscription's services. Available options are:

  • BASED_ON_NUMBER_OF_INSTALLED_ITEMS,
  • BASED_ON_MAXIMUM_CAPACITY
  • BASED_ON_ACTUAL_CAPACITY

Available from CRM.COM R15.0.0


 billing_term_scheme object response data

Name

Type

Description

id

String

The ID of the retrieved billing term scheme

codeStringThe code of the retrieved billing term scheme
nameStringThe name of the retrieved billing term scheme
life_cycle_stateString

The life cycle state of the retrieved billing term scheme. The supported life cycle states are the following

DRAFT, EFFECTIVE, TERMINATED

classificationString

The classification of the retrieved billing term scheme which can be either NORMAL or PREPAID

Classification options NORMAL and PREPAID are available from CRM.COM R15.0.0

Prior CRM.COM R15.0.0 the options are SUBSCRIPTIONS or JOBS

billing_typeString

The billing type of the billing term scheme which can be PRE_BILL or POST_BILL for NORMAL billing term schemes and PRE_RATED or POST_RATED for PREPAID billing term schemes

Billing type options PRE/POST_BILL and PRE/POST_RATED are available from CRM.COM R15.0.0

Prior CRM.COM R15.0.0 the options are NORMAL and PREPAID

billing_methodStringThe billing method of the billing term scheme which can be ANNIVERSARY or PERIOD

 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

 billing frequency object response data

Name

Type

Description

code

String

The code of the retrieved billing frequency

name

String

The name of the retrieved billing frequency


 binding_information object response data

Name

Type

Description

stateStringThe binding state which can be INBINDING or OUTOFBINDING
start_dateDateThe date that the binding period starts
end_dateDateThe date that the binding period ends
binding_periodBinding period objectThe binding period

Referred Objects Response Data

 binding period object response data

Name

Type

Description

code

String

The code of the retrieved binding period

name

String

The name of the retrieved binding period