Class: Recurly::Requests::PlanUpdate

Inherits:
Recurly::Request show all
Defined in:
lib/recurly/requests/plan_update.rb

Instance Attribute Summary collapse

Attributes inherited from Recurly::Request

#attributes

Method Summary

Methods inherited from Recurly::Request

#==, #to_s

Methods included from Schema::SchemaFactory

#schema

Methods included from Schema::RequestCaster

#cast_request

Methods included from Schema::ResourceCaster

#cast

Methods included from Schema::SchemaValidator

#get_did_you_mean, #validate!, #validate_attribute!

Instance Attribute Details

#accounting_code ⇒ String

Returns Accounting code for invoice line items for the plan. If no value is provided, it defaults to plan's code.

Returns:

  • (String) —

    Accounting code for invoice line items for the plan. If no value is provided, it defaults to plan's code.



11
 
# File 'lib/recurly/requests/plan_update.rb', line 11

define_attribute :accounting_code, String

#allow_any_item_on_subscriptions ⇒ Boolean

Returns Used to determine whether items can be assigned as add-ons to individual subscriptions. If `true`, items can be assigned as add-ons to individual subscription add-ons. If `false`, only plan add-ons can be used.

Returns:

  • (Boolean) —

    Used to determine whether items can be assigned as add-ons to individual subscriptions. If `true`, items can be assigned as add-ons to individual subscription add-ons. If `false`, only plan add-ons can be used.



15
 
# File 'lib/recurly/requests/plan_update.rb', line 15

define_attribute :allow_any_item_on_subscriptions, :Boolean

#auto_renew ⇒ Boolean

Returns Subscriptions will automatically inherit this value once they are active. If `auto_renew` is `true`, then a subscription will automatically renew its term at renewal. If `auto_renew` is `false`, then a subscription will expire at the end of its term. `auto_renew` can be overridden on the subscription record itself.

Returns:

  • (Boolean) —

    Subscriptions will automatically inherit this value once they are active. If `auto_renew` is `true`, then a subscription will automatically renew its term at renewal. If `auto_renew` is `false`, then a subscription will expire at the end of its term. `auto_renew` can be overridden on the subscription record itself.



19
 
# File 'lib/recurly/requests/plan_update.rb', line 19

define_attribute :auto_renew, :Boolean

#avalara_service_type ⇒ Integer

Returns Used by Avalara for Communications taxes. The transaction type in combination with the service type describe how the plan is taxed. Refer to [the documentation](help.avalara.com/AvaTax_for_Communications/Tax_Calculation/AvaTax_for_Communications_Tax_Engine/Mapping_Resources/TM_00115_AFC_Modules_Corresponding_Transaction_Types) for more available t/s types.

Returns:



23
 
# File 'lib/recurly/requests/plan_update.rb', line 23

define_attribute :avalara_service_type, Integer

#avalara_transaction_type ⇒ Integer

Returns Used by Avalara for Communications taxes. The transaction type in combination with the service type describe how the plan is taxed. Refer to [the documentation](help.avalara.com/AvaTax_for_Communications/Tax_Calculation/AvaTax_for_Communications_Tax_Engine/Mapping_Resources/TM_00115_AFC_Modules_Corresponding_Transaction_Types) for more available t/s types.

Returns:



27
 
# File 'lib/recurly/requests/plan_update.rb', line 27

define_attribute :avalara_transaction_type, Integer

#code ⇒ String

Returns Unique code to identify the plan. This is used in Hosted Payment Page URLs and in the invoice exports.

Returns:

  • (String) —

    Unique code to identify the plan. This is used in Hosted Payment Page URLs and in the invoice exports.



31
 
# File 'lib/recurly/requests/plan_update.rb', line 31

define_attribute :code, String

#currencies ⇒ Array[PlanPricing]

Returns Optional when the pricing model is 'ramp'.

Returns:

  • (Array[PlanPricing]) —

    Optional when the pricing model is 'ramp'.



35
 
# File 'lib/recurly/requests/plan_update.rb', line 35

define_attribute :currencies, Array, { :item_type => :PlanPricing }

#custom_fields ⇒ Array[CustomField]

Returns The custom fields will only be altered when they are included in a request. Sending an empty array will not remove any existing values. To remove a field send the name with a null or empty value.

Returns:

  • (Array[CustomField]) —

    The custom fields will only be altered when they are included in a request. Sending an empty array will not remove any existing values. To remove a field send the name with a null or empty value.



39
 
# File 'lib/recurly/requests/plan_update.rb', line 39

define_attribute :custom_fields, Array, { :item_type => :CustomField }

#description ⇒ String

Returns Optional description, not displayed.

Returns:

  • (String) —

    Optional description, not displayed.



43
 
# File 'lib/recurly/requests/plan_update.rb', line 43

define_attribute :description, String

#dunning_campaign_id ⇒ String

Returns Unique ID to identify a dunning campaign. Used to specify if a non-default dunning campaign should be assigned to this plan. For sites without multiple dunning campaigns enabled, the default dunning campaign will always be used.

Returns:

  • (String) —

    Unique ID to identify a dunning campaign. Used to specify if a non-default dunning campaign should be assigned to this plan. For sites without multiple dunning campaigns enabled, the default dunning campaign will always be used.



47
 
# File 'lib/recurly/requests/plan_update.rb', line 47

define_attribute :dunning_campaign_id, String

#hosted_pages ⇒ PlanHostedPages

Returns Hosted pages settings.

Returns:



51
 
# File 'lib/recurly/requests/plan_update.rb', line 51

define_attribute :hosted_pages, :PlanHostedPages

#id ⇒ String

Returns Plan ID.

Returns:

  • (String) —

    Plan ID



55
 
# File 'lib/recurly/requests/plan_update.rb', line 55

define_attribute :id, String

#liability_gl_account_id ⇒ String

Returns The ID of a general ledger account. General ledger accounts are only accessible as a part of the Recurly RevRec Standard and Recurly RevRec Advanced features.

Returns:

  • (String) —

    The ID of a general ledger account. General ledger accounts are only accessible as a part of the Recurly RevRec Standard and Recurly RevRec Advanced features.



59
 
# File 'lib/recurly/requests/plan_update.rb', line 59

define_attribute :liability_gl_account_id, String

#name ⇒ String

Returns This name describes your plan and will appear on the Hosted Payment Page and the subscriber's invoice.

Returns:

  • (String) —

    This name describes your plan and will appear on the Hosted Payment Page and the subscriber's invoice.



63
 
# File 'lib/recurly/requests/plan_update.rb', line 63

define_attribute :name, String

#performance_obligation_id ⇒ String

Returns The ID of a performance obligation. Performance obligations are only accessible as a part of the Recurly RevRec Standard and Recurly RevRec Advanced features.

Returns:

  • (String) —

    The ID of a performance obligation. Performance obligations are only accessible as a part of the Recurly RevRec Standard and Recurly RevRec Advanced features.



67
 
# File 'lib/recurly/requests/plan_update.rb', line 67

define_attribute :performance_obligation_id, String

#ramp_intervals ⇒ Array[PlanRampInterval]

Returns Ramp Intervals.

Returns:



71
 
# File 'lib/recurly/requests/plan_update.rb', line 71

define_attribute :ramp_intervals, Array, { :item_type => :PlanRampInterval }

#revenue_gl_account_id ⇒ String

Returns The ID of a general ledger account. General ledger accounts are only accessible as a part of the Recurly RevRec Standard and Recurly RevRec Advanced features.

Returns:

  • (String) —

    The ID of a general ledger account. General ledger accounts are only accessible as a part of the Recurly RevRec Standard and Recurly RevRec Advanced features.



75
 
# File 'lib/recurly/requests/plan_update.rb', line 75

define_attribute :revenue_gl_account_id, String

#revenue_schedule_type ⇒ String

Returns Revenue schedule type.

Returns:

  • (String) —

    Revenue schedule type



79
 
# File 'lib/recurly/requests/plan_update.rb', line 79

define_attribute :revenue_schedule_type, String

#setup_fee_accounting_code ⇒ String

Returns Accounting code for invoice line items for the plan's setup fee. If no value is provided, it defaults to plan's accounting code.

Returns:

  • (String) —

    Accounting code for invoice line items for the plan's setup fee. If no value is provided, it defaults to plan's accounting code.



83
 
# File 'lib/recurly/requests/plan_update.rb', line 83

define_attribute :setup_fee_accounting_code, String

#setup_fee_liability_gl_account_id ⇒ String

Returns The ID of a general ledger account. General ledger accounts are only accessible as a part of the Recurly RevRec Standard and Recurly RevRec Advanced features.

Returns:

  • (String) —

    The ID of a general ledger account. General ledger accounts are only accessible as a part of the Recurly RevRec Standard and Recurly RevRec Advanced features.



87
 
# File 'lib/recurly/requests/plan_update.rb', line 87

define_attribute :setup_fee_liability_gl_account_id, String

#setup_fee_performance_obligation_id ⇒ String

Returns The ID of a performance obligation. Performance obligations are only accessible as a part of the Recurly RevRec Standard and Recurly RevRec Advanced features.

Returns:

  • (String) —

    The ID of a performance obligation. Performance obligations are only accessible as a part of the Recurly RevRec Standard and Recurly RevRec Advanced features.



91
 
# File 'lib/recurly/requests/plan_update.rb', line 91

define_attribute :setup_fee_performance_obligation_id, String

#setup_fee_revenue_gl_account_id ⇒ String

Returns The ID of a general ledger account. General ledger accounts are only accessible as a part of the Recurly RevRec Standard and Recurly RevRec Advanced features.

Returns:

  • (String) —

    The ID of a general ledger account. General ledger accounts are only accessible as a part of the Recurly RevRec Standard and Recurly RevRec Advanced features.



95
 
# File 'lib/recurly/requests/plan_update.rb', line 95

define_attribute :setup_fee_revenue_gl_account_id, String

#setup_fee_revenue_schedule_type ⇒ String

Returns Setup fee revenue schedule type.

Returns:

  • (String) —

    Setup fee revenue schedule type



99
 
# File 'lib/recurly/requests/plan_update.rb', line 99

define_attribute :setup_fee_revenue_schedule_type, String

#tax_code ⇒ String

Returns Optional field used by Avalara, Vertex, and Recurly's In-the-Box tax solution to determine taxation rules. You can pass in specific tax codes using any of these tax integrations. For Recurly's In-the-Box tax offering you can also choose to instead use simple values of `unknown`, `physical`, or `digital` tax codes.

Returns:

  • (String) —

    Optional field used by Avalara, Vertex, and Recurly's In-the-Box tax solution to determine taxation rules. You can pass in specific tax codes using any of these tax integrations. For Recurly's In-the-Box tax offering you can also choose to instead use simple values of `unknown`, `physical`, or `digital` tax codes.



103
 
# File 'lib/recurly/requests/plan_update.rb', line 103

define_attribute :tax_code, String

#tax_exempt ⇒ Boolean

Returns `true` exempts tax on the plan, `false` applies tax on the plan.

Returns:

  • (Boolean) —

    `true` exempts tax on the plan, `false` applies tax on the plan.



107
 
# File 'lib/recurly/requests/plan_update.rb', line 107

define_attribute :tax_exempt, :Boolean

#total_billing_cycles ⇒ Integer

Returns Automatically terminate plans after a defined number of billing cycles.

Returns:

  • (Integer) —

    Automatically terminate plans after a defined number of billing cycles.



111
 
# File 'lib/recurly/requests/plan_update.rb', line 111

define_attribute :total_billing_cycles, Integer

#trial_length ⇒ Integer

Returns Length of plan's trial period in `trial_units`. `0` means `no trial`.

Returns:

  • (Integer) —

    Length of plan's trial period in `trial_units`. `0` means `no trial`.



115
 
# File 'lib/recurly/requests/plan_update.rb', line 115

define_attribute :trial_length, Integer

#trial_requires_billing_info ⇒ Boolean

Returns Allow free trial subscriptions to be created without billing info. Should not be used if billing info is needed for initial invoice due to existing uninvoiced charges or setup fee.

Returns:

  • (Boolean) —

    Allow free trial subscriptions to be created without billing info. Should not be used if billing info is needed for initial invoice due to existing uninvoiced charges or setup fee.



119
 
# File 'lib/recurly/requests/plan_update.rb', line 119

define_attribute :trial_requires_billing_info, :Boolean

#trial_unit ⇒ String

Returns Units for the plan's trial period.

Returns:

  • (String) —

    Units for the plan's trial period.



123
 
# File 'lib/recurly/requests/plan_update.rb', line 123

define_attribute :trial_unit, String