maxio-advanced-billing-sdk 7.0.0 → 8.0.0

data/lib/advanced_billing/models/component.rb

@@ -62,10 +62,6 @@ module AdvancedBilling
     # @return [TrueClass | FalseClass]
     attr_accessor :archived
 
-    # Boolean flag describing whether a component is taxable or not.
-    # @return [TrueClass | FalseClass]
-    attr_accessor :taxable
-
     # The description of the component.
     # @return [String]
     attr_accessor :description
@@ -98,15 +94,19 @@ module AdvancedBilling
     # @return [String]
     attr_accessor :default_price_point_name
 
+    # Boolean flag describing whether a component is taxable or not.
+    # @return [TrueClass | FalseClass]
+    attr_accessor :taxable
+
     # A string representing the tax code related to the component type. This is
-    # especially important when using the Avalara service to tax based on
-    # locale. This attribute has a max length of 10 characters.
+    # especially important when using AvaTax to tax based on locale. This
+    # attribute has a max length of 25 characters.
     # @return [String]
     attr_accessor :tax_code
 
     # A string representing the tax code related to the component type. This is
-    # especially important when using the Avalara service to tax based on
-    # locale. This attribute has a max length of 10 characters.
+    # especially important when using AvaTax to tax based on locale. This
+    # attribute has a max length of 25 characters.
     # @return [TrueClass | FalseClass]
     attr_accessor :recurring
 
@@ -193,7 +193,6 @@ module AdvancedBilling
       @_hash['price_per_unit_in_cents'] = 'price_per_unit_in_cents'
       @_hash['kind'] = 'kind'
       @_hash['archived'] = 'archived'
-      @_hash['taxable'] = 'taxable'
       @_hash['description'] = 'description'
       @_hash['default_price_point_id'] = 'default_price_point_id'
       @_hash['overage_prices'] = 'overage_prices'
@@ -201,6 +200,7 @@ module AdvancedBilling
       @_hash['price_point_count'] = 'price_point_count'
       @_hash['price_points_url'] = 'price_points_url'
       @_hash['default_price_point_name'] = 'default_price_point_name'
+      @_hash['taxable'] = 'taxable'
       @_hash['tax_code'] = 'tax_code'
       @_hash['recurring'] = 'recurring'
       @_hash['upgrade_charge'] = 'upgrade_charge'
@@ -235,7 +235,6 @@ module AdvancedBilling
         price_per_unit_in_cents
         kind
         archived
-        taxable
         description
         default_price_point_id
         overage_prices
@@ -243,6 +242,7 @@ module AdvancedBilling
         price_point_count
         price_points_url
         default_price_point_name
+        taxable
         tax_code
         recurring
         upgrade_charge
@@ -288,13 +288,13 @@ module AdvancedBilling
                    unit_name: SKIP, unit_price: SKIP, product_family_id: SKIP,
                    product_family_name: SKIP, product_family_handle: SKIP,
                    price_per_unit_in_cents: SKIP, kind: SKIP, archived: SKIP,
-                   taxable: SKIP, description: SKIP,
-                   default_price_point_id: SKIP, overage_prices: SKIP,
-                   prices: SKIP, price_point_count: SKIP,
+                   description: SKIP, default_price_point_id: SKIP,
+                   overage_prices: SKIP, prices: SKIP, price_point_count: SKIP,
                    price_points_url: SKIP, default_price_point_name: SKIP,
-                   tax_code: SKIP, recurring: SKIP, upgrade_charge: SKIP,
-                   downgrade_credit: SKIP, created_at: SKIP, updated_at: SKIP,
-                   archived_at: SKIP, hide_date_range_on_invoice: SKIP,
+                   taxable: SKIP, tax_code: SKIP, recurring: SKIP,
+                   upgrade_charge: SKIP, downgrade_credit: SKIP,
+                   created_at: SKIP, updated_at: SKIP, archived_at: SKIP,
+                   hide_date_range_on_invoice: SKIP,
                    allow_fractional_quantities: SKIP, item_category: SKIP,
                    use_site_exchange_rate: SKIP, accounting_code: SKIP,
                    event_based_billing_metric_id: SKIP, interval: SKIP,
@@ -316,7 +316,6 @@ module AdvancedBilling
       @price_per_unit_in_cents = price_per_unit_in_cents unless price_per_unit_in_cents == SKIP
       @kind = kind unless kind == SKIP
       @archived = archived unless archived == SKIP
-      @taxable = taxable unless taxable == SKIP
       @description = description unless description == SKIP
       @default_price_point_id = default_price_point_id unless default_price_point_id == SKIP
       @overage_prices = overage_prices unless overage_prices == SKIP
@@ -324,6 +323,7 @@ module AdvancedBilling
       @price_point_count = price_point_count unless price_point_count == SKIP
       @price_points_url = price_points_url unless price_points_url == SKIP
       @default_price_point_name = default_price_point_name unless default_price_point_name == SKIP
+      @taxable = taxable unless taxable == SKIP
       @tax_code = tax_code unless tax_code == SKIP
       @recurring = recurring unless recurring == SKIP
       @upgrade_charge = upgrade_charge unless upgrade_charge == SKIP
@@ -372,7 +372,6 @@ module AdvancedBilling
         hash.key?('price_per_unit_in_cents') ? hash['price_per_unit_in_cents'] : SKIP
       kind = hash.key?('kind') ? hash['kind'] : SKIP
       archived = hash.key?('archived') ? hash['archived'] : SKIP
-      taxable = hash.key?('taxable') ? hash['taxable'] : SKIP
       description = hash.key?('description') ? hash['description'] : SKIP
       default_price_point_id =
         hash.key?('default_price_point_id') ? hash['default_price_point_id'] : SKIP
@@ -402,6 +401,7 @@ module AdvancedBilling
         hash.key?('price_points_url') ? hash['price_points_url'] : SKIP
       default_price_point_name =
         hash.key?('default_price_point_name') ? hash['default_price_point_name'] : SKIP
+      taxable = hash.key?('taxable') ? hash['taxable'] : SKIP
       tax_code = hash.key?('tax_code') ? hash['tax_code'] : SKIP
       recurring = hash.key?('recurring') ? hash['recurring'] : SKIP
       upgrade_charge =
@@ -453,7 +453,6 @@ module AdvancedBilling
                     price_per_unit_in_cents: price_per_unit_in_cents,
                     kind: kind,
                     archived: archived,
-                    taxable: taxable,
                     description: description,
                     default_price_point_id: default_price_point_id,
                     overage_prices: overage_prices,
@@ -461,6 +460,7 @@ module AdvancedBilling
                     price_point_count: price_point_count,
                     price_points_url: price_points_url,
                     default_price_point_name: default_price_point_name,
+                    taxable: taxable,
                     tax_code: tax_code,
                     recurring: recurring,
                     upgrade_charge: upgrade_charge,
@@ -498,13 +498,13 @@ module AdvancedBilling
       " #{@pricing_scheme}, unit_name: #{@unit_name}, unit_price: #{@unit_price},"\
       " product_family_id: #{@product_family_id}, product_family_name: #{@product_family_name},"\
       " product_family_handle: #{@product_family_handle}, price_per_unit_in_cents:"\
-      " #{@price_per_unit_in_cents}, kind: #{@kind}, archived: #{@archived}, taxable: #{@taxable},"\
-      " description: #{@description}, default_price_point_id: #{@default_price_point_id},"\
-      " overage_prices: #{@overage_prices}, prices: #{@prices}, price_point_count:"\
-      " #{@price_point_count}, price_points_url: #{@price_points_url}, default_price_point_name:"\
-      " #{@default_price_point_name}, tax_code: #{@tax_code}, recurring: #{@recurring},"\
-      " upgrade_charge: #{@upgrade_charge}, downgrade_credit: #{@downgrade_credit}, created_at:"\
-      " #{@created_at}, updated_at: #{@updated_at}, archived_at: #{@archived_at},"\
+      " #{@price_per_unit_in_cents}, kind: #{@kind}, archived: #{@archived}, description:"\
+      " #{@description}, default_price_point_id: #{@default_price_point_id}, overage_prices:"\
+      " #{@overage_prices}, prices: #{@prices}, price_point_count: #{@price_point_count},"\
+      " price_points_url: #{@price_points_url}, default_price_point_name:"\
+      " #{@default_price_point_name}, taxable: #{@taxable}, tax_code: #{@tax_code}, recurring:"\
+      " #{@recurring}, upgrade_charge: #{@upgrade_charge}, downgrade_credit: #{@downgrade_credit},"\
+      " created_at: #{@created_at}, updated_at: #{@updated_at}, archived_at: #{@archived_at},"\
       " hide_date_range_on_invoice: #{@hide_date_range_on_invoice}, allow_fractional_quantities:"\
       " #{@allow_fractional_quantities}, item_category: #{@item_category}, use_site_exchange_rate:"\
       " #{@use_site_exchange_rate}, accounting_code: #{@accounting_code},"\
@@ -521,11 +521,11 @@ module AdvancedBilling
       " product_family_name: #{@product_family_name.inspect}, product_family_handle:"\
       " #{@product_family_handle.inspect}, price_per_unit_in_cents:"\
       " #{@price_per_unit_in_cents.inspect}, kind: #{@kind.inspect}, archived:"\
-      " #{@archived.inspect}, taxable: #{@taxable.inspect}, description: #{@description.inspect},"\
-      " default_price_point_id: #{@default_price_point_id.inspect}, overage_prices:"\
-      " #{@overage_prices.inspect}, prices: #{@prices.inspect}, price_point_count:"\
-      " #{@price_point_count.inspect}, price_points_url: #{@price_points_url.inspect},"\
-      " default_price_point_name: #{@default_price_point_name.inspect}, tax_code:"\
+      " #{@archived.inspect}, description: #{@description.inspect}, default_price_point_id:"\
+      " #{@default_price_point_id.inspect}, overage_prices: #{@overage_prices.inspect}, prices:"\
+      " #{@prices.inspect}, price_point_count: #{@price_point_count.inspect}, price_points_url:"\
+      " #{@price_points_url.inspect}, default_price_point_name:"\
+      " #{@default_price_point_name.inspect}, taxable: #{@taxable.inspect}, tax_code:"\
       " #{@tax_code.inspect}, recurring: #{@recurring.inspect}, upgrade_charge:"\
       " #{@upgrade_charge.inspect}, downgrade_credit: #{@downgrade_credit.inspect}, created_at:"\
       " #{@created_at.inspect}, updated_at: #{@updated_at.inspect}, archived_at:"\

data/lib/advanced_billing/models/component_custom_price.rb

@@ -35,6 +35,26 @@ module AdvancedBilling
     # @return [Array[Price]]
     attr_accessor :prices
 
+    # Applicable only to prepaid usage components. Controls whether the
+    # allocated quantity renews each period.
+    # @return [TrueClass | FalseClass]
+    attr_accessor :renew_prepaid_allocation
+
+    # Applicable only to prepaid usage components. Controls whether remaining
+    # units roll over to the next period.
+    # @return [TrueClass | FalseClass]
+    attr_accessor :rollover_prepaid_remainder
+
+    # Applicable only when rollover is enabled. Number of
+    # `expiration_interval_unit`s after which rollover amounts expire.
+    # @return [Integer]
+    attr_accessor :expiration_interval
+
+    # Applicable only when rollover is enabled. Interval unit for rollover
+    # expiration (month or day).
+    # @return [ExpirationIntervalUnit]
+    attr_accessor :expiration_interval_unit
+
     # A mapping from model property names to API property names.
     def self.names
       @_hash = {} if @_hash.nil?
@@ -43,6 +63,10 @@ module AdvancedBilling
       @_hash['interval'] = 'interval'
       @_hash['interval_unit'] = 'interval_unit'
       @_hash['prices'] = 'prices'
+      @_hash['renew_prepaid_allocation'] = 'renew_prepaid_allocation'
+      @_hash['rollover_prepaid_remainder'] = 'rollover_prepaid_remainder'
+      @_hash['expiration_interval'] = 'expiration_interval'
+      @_hash['expiration_interval_unit'] = 'expiration_interval_unit'
       @_hash
     end
 
@@ -53,6 +77,10 @@ module AdvancedBilling
         pricing_scheme
         interval
         interval_unit
+        renew_prepaid_allocation
+        rollover_prepaid_remainder
+        expiration_interval
+        expiration_interval_unit
       ]
     end
 
@@ -60,12 +88,16 @@ module AdvancedBilling
     def self.nullables
       %w[
         interval_unit
+        expiration_interval
+        expiration_interval_unit
       ]
     end
 
     def initialize(prices:, tax_included: SKIP, pricing_scheme: SKIP,
                    interval: SKIP, interval_unit: SKIP,
-                   additional_properties: {})
+                   renew_prepaid_allocation: SKIP,
+                   rollover_prepaid_remainder: SKIP, expiration_interval: SKIP,
+                   expiration_interval_unit: SKIP, additional_properties: {})
       # Add additional model properties to the instance.
       additional_properties.each do |_name, _value|
         instance_variable_set("@#{_name}", _value)
@@ -76,6 +108,13 @@ module AdvancedBilling
       @interval = interval unless interval == SKIP
       @interval_unit = interval_unit unless interval_unit == SKIP
       @prices = prices
+      @renew_prepaid_allocation = renew_prepaid_allocation unless renew_prepaid_allocation == SKIP
+      unless rollover_prepaid_remainder == SKIP
+        @rollover_prepaid_remainder =
+          rollover_prepaid_remainder
+      end
+      @expiration_interval = expiration_interval unless expiration_interval == SKIP
+      @expiration_interval_unit = expiration_interval_unit unless expiration_interval_unit == SKIP
     end
 
     # Creates an instance of the object from a hash.
@@ -98,6 +137,14 @@ module AdvancedBilling
         hash.key?('pricing_scheme') ? hash['pricing_scheme'] : SKIP
       interval = hash.key?('interval') ? hash['interval'] : SKIP
       interval_unit = hash.key?('interval_unit') ? hash['interval_unit'] : SKIP
+      renew_prepaid_allocation =
+        hash.key?('renew_prepaid_allocation') ? hash['renew_prepaid_allocation'] : SKIP
+      rollover_prepaid_remainder =
+        hash.key?('rollover_prepaid_remainder') ? hash['rollover_prepaid_remainder'] : SKIP
+      expiration_interval =
+        hash.key?('expiration_interval') ? hash['expiration_interval'] : SKIP
+      expiration_interval_unit =
+        hash.key?('expiration_interval_unit') ? hash['expiration_interval_unit'] : SKIP
 
       # Clean out expected properties from Hash.
       additional_properties = hash.reject { |k, _| names.value?(k) }
@@ -108,6 +155,10 @@ module AdvancedBilling
                                pricing_scheme: pricing_scheme,
                                interval: interval,
                                interval_unit: interval_unit,
+                               renew_prepaid_allocation: renew_prepaid_allocation,
+                               rollover_prepaid_remainder: rollover_prepaid_remainder,
+                               expiration_interval: expiration_interval,
+                               expiration_interval_unit: expiration_interval_unit,
                                additional_properties: additional_properties)
     end
 
@@ -134,7 +185,10 @@ module AdvancedBilling
       class_name = self.class.name.split('::').last
       "<#{class_name} tax_included: #{@tax_included}, pricing_scheme: #{@pricing_scheme},"\
       " interval: #{@interval}, interval_unit: #{@interval_unit}, prices: #{@prices},"\
-      " additional_properties: #{get_additional_properties}>"
+      " renew_prepaid_allocation: #{@renew_prepaid_allocation}, rollover_prepaid_remainder:"\
+      " #{@rollover_prepaid_remainder}, expiration_interval: #{@expiration_interval},"\
+      " expiration_interval_unit: #{@expiration_interval_unit}, additional_properties:"\
+      " #{get_additional_properties}>"
     end
 
     # Provides a debugging-friendly string with detailed object information.
@@ -142,7 +196,11 @@ module AdvancedBilling
       class_name = self.class.name.split('::').last
       "<#{class_name} tax_included: #{@tax_included.inspect}, pricing_scheme:"\
       " #{@pricing_scheme.inspect}, interval: #{@interval.inspect}, interval_unit:"\
-      " #{@interval_unit.inspect}, prices: #{@prices.inspect}, additional_properties:"\
+      " #{@interval_unit.inspect}, prices: #{@prices.inspect}, renew_prepaid_allocation:"\
+      " #{@renew_prepaid_allocation.inspect}, rollover_prepaid_remainder:"\
+      " #{@rollover_prepaid_remainder.inspect}, expiration_interval:"\
+      " #{@expiration_interval.inspect}, expiration_interval_unit:"\
+      " #{@expiration_interval_unit.inspect}, additional_properties:"\
       " #{get_additional_properties}>"
     end
   end

data/lib/advanced_billing/models/component_kind.rb

@@ -28,5 +28,21 @@ module AdvancedBilling
 
       COMPONENT_KIND.include?(value)
     end
+
+    def self.from_value(value, default_value = METERED_COMPONENT)
+      return default_value if value.nil?
+
+      str = value.to_s.strip
+
+      case str.downcase
+      when 'metered_component' then METERED_COMPONENT
+      when 'quantity_based_component' then QUANTITY_BASED_COMPONENT
+      when 'on_off_component' then ON_OFF_COMPONENT
+      when 'prepaid_usage_component' then PREPAID_USAGE_COMPONENT
+      when 'event_based_component' then EVENT_BASED_COMPONENT
+      else
+        default_value
+      end
+    end
   end
 end

data/lib/advanced_billing/models/compounding_strategy.rb

@@ -23,5 +23,18 @@ module AdvancedBilling
 
       COMPOUNDING_STRATEGY.include?(value)
     end
+
+    def self.from_value(value, default_value = COMPOUND)
+      return default_value if value.nil?
+
+      str = value.to_s.strip
+
+      case str.downcase
+      when 'compound' then COMPOUND
+      when 'fullprice' then FULLPRICE
+      else
+        default_value
+      end
+    end
   end
 end

data/lib/advanced_billing/models/create_allocation.rb

@@ -68,8 +68,7 @@ module AdvancedBilling
 
     # This attribute is particularly useful when you need to align billing
     # events for different components on distinct schedules within a
-    # subscription. Please note this only works for site with Multifrequency
-    # enabled
+    # subscription. This only works for site with Multifrequency enabled.
     # @return [BillingSchedule]
     attr_accessor :billing_schedule
 

data/lib/advanced_billing/models/create_invoice_coupon.rb

@@ -13,6 +13,10 @@ module AdvancedBilling
     # @return [String]
     attr_accessor :code
 
+    # TODO: Write general description for this method
+    # @return [String]
+    attr_accessor :subcode
+
     # TODO: Write general description for this method
     # @return [Object]
     attr_accessor :percentage
@@ -41,6 +45,7 @@ module AdvancedBilling
     def self.names
       @_hash = {} if @_hash.nil?
       @_hash['code'] = 'code'
+      @_hash['subcode'] = 'subcode'
       @_hash['percentage'] = 'percentage'
       @_hash['amount'] = 'amount'
       @_hash['description'] = 'description'
@@ -53,6 +58,7 @@ module AdvancedBilling
     def self.optionals
       %w[
         code
+        subcode
         percentage
         amount
         description
@@ -66,7 +72,7 @@ module AdvancedBilling
       []
     end
 
-    def initialize(code: SKIP, percentage: SKIP, amount: SKIP,
+    def initialize(code: SKIP, subcode: SKIP, percentage: SKIP, amount: SKIP,
                    description: SKIP, product_family_id: SKIP,
                    compounding_strategy: SKIP, additional_properties: {})
       # Add additional model properties to the instance.
@@ -75,6 +81,7 @@ module AdvancedBilling
       end
 
       @code = code unless code == SKIP
+      @subcode = subcode unless subcode == SKIP
       @percentage = percentage unless percentage == SKIP
       @amount = amount unless amount == SKIP
       @description = description unless description == SKIP
@@ -88,6 +95,7 @@ module AdvancedBilling
 
       # Extract variables from the hash.
       code = hash.key?('code') ? hash['code'] : SKIP
+      subcode = hash.key?('subcode') ? hash['subcode'] : SKIP
       percentage = hash.key?('percentage') ? APIHelper.deserialize_union_type(
         UnionTypeLookUp.get(:CreateInvoiceCouponPercentage), hash['percentage']
       ) : SKIP
@@ -106,6 +114,7 @@ module AdvancedBilling
 
       # Create object from extracted values.
       CreateInvoiceCoupon.new(code: code,
+                              subcode: subcode,
                               percentage: percentage,
                               amount: amount,
                               description: description,
@@ -127,8 +136,8 @@ module AdvancedBilling
     # Provides a human-readable string representation of the object.
     def to_s
       class_name = self.class.name.split('::').last
-      "<#{class_name} code: #{@code}, percentage: #{@percentage}, amount: #{@amount},"\
-      " description: #{@description}, product_family_id: #{@product_family_id},"\
+      "<#{class_name} code: #{@code}, subcode: #{@subcode}, percentage: #{@percentage}, amount:"\
+      " #{@amount}, description: #{@description}, product_family_id: #{@product_family_id},"\
       " compounding_strategy: #{@compounding_strategy}, additional_properties:"\
       " #{get_additional_properties}>"
     end
@@ -136,10 +145,10 @@ module AdvancedBilling
     # Provides a debugging-friendly string with detailed object information.
     def inspect
       class_name = self.class.name.split('::').last
-      "<#{class_name} code: #{@code.inspect}, percentage: #{@percentage.inspect}, amount:"\
-      " #{@amount.inspect}, description: #{@description.inspect}, product_family_id:"\
-      " #{@product_family_id.inspect}, compounding_strategy: #{@compounding_strategy.inspect},"\
-      " additional_properties: #{get_additional_properties}>"
+      "<#{class_name} code: #{@code.inspect}, subcode: #{@subcode.inspect}, percentage:"\
+      " #{@percentage.inspect}, amount: #{@amount.inspect}, description: #{@description.inspect},"\
+      " product_family_id: #{@product_family_id.inspect}, compounding_strategy:"\
+      " #{@compounding_strategy.inspect}, additional_properties: #{get_additional_properties}>"
     end
   end
 end

data/lib/advanced_billing/models/create_invoice_item.rb

@@ -26,14 +26,14 @@ module AdvancedBilling
     attr_accessor :unit_price
 
     # Set to true to automatically calculate taxes. Site must be configured to
-    # use and calculate taxes.
-    # If using Avalara, a tax_code parameter must also be sent.
+    # use and calculate taxes. If using AvaTax, a tax_code parameter must also
+    # be sent.
     # @return [TrueClass | FalseClass]
     attr_accessor :taxable
 
-    # Set to true to automatically calculate taxes. Site must be configured to
-    # use and calculate taxes.
-    # If using Avalara, a tax_code parameter must also be sent.
+    # A string representing the tax code related to the product type. This is
+    # especially important when using AvaTax to tax based on locale. This
+    # attribute has a max length of 25 characters.
     # @return [String]
     attr_accessor :tax_code
 

data/lib/advanced_billing/models/create_invoice_status.rb

@@ -19,5 +19,18 @@ module AdvancedBilling
 
       CREATE_INVOICE_STATUS.include?(value)
     end
+
+    def self.from_value(value, default_value = DRAFT)
+      return default_value if value.nil?
+
+      str = value.to_s.strip
+
+      case str.downcase
+      when 'draft' then DRAFT
+      when 'open' then OPEN
+      else
+        default_value
+      end
+    end
   end
 end

data/lib/advanced_billing/models/create_metafield.rb

@@ -19,11 +19,9 @@ module AdvancedBilling
     # @return [MetafieldScope]
     attr_accessor :scope
 
-    # Indicates how data should be added to the metafield. For example, a text
-    # type is just a string, so a given metafield of this type can have any
-    # value attached. On the other hand, dropdown and radio have a set of
-    # allowed values that can be input, and appear differently on a Public
-    # Signup Page. Defaults to 'text'
+    # Indicates the type of metafield. A text metafield allows any string value.
+    # Dropdown and radio metafields have a set of values that can be selected.
+    # Defaults to 'text'.
     # @return [MetafieldInput]
     attr_accessor :input_type
 

data/lib/advanced_billing/models/create_or_update_product.rb

@@ -26,8 +26,8 @@ module AdvancedBilling
     attr_accessor :accounting_code
 
     # Deprecated value that can be ignored unless you have legacy hosted pages.
-    # For Public Signup Page users, please read this attribute from under the
-    # signup page.
+    # For Public Signup Page users, read this attribute from under the signup
+    # page.
     # @return [TrueClass | FalseClass]
     attr_accessor :require_credit_card
 
@@ -60,9 +60,13 @@ module AdvancedBilling
     # @return [IntervalUnit]
     attr_accessor :trial_interval_unit
 
-    # A string representing the trial interval unit for this product, either
-    # month or day
-    # @return [String]
+    # Indicates how a trial is handled when the trail period ends and there is
+    # no credit card on file. For `no_obligation`, the subscription transitions
+    # to a Trial Ended state. Maxio will not send any emails or statements. For
+    # `payment_expected`, the subscription transitions to a Past Due state.
+    # Maxio will send normal dunning emails and statements according to your
+    # other settings.
+    # @return [TrialType]
     attr_accessor :trial_type
 
     # The numerical expiration interval. i.e. an expiration_interval of ‘30’
@@ -82,8 +86,8 @@ module AdvancedBilling
     attr_accessor :auto_create_signup_page
 
     # A string representing the tax code related to the product type. This is
-    # especially important when using the Avalara service to tax based on
-    # locale. This attribute has a max length of 10 characters.
+    # especially important when using AvaTax to tax based on locale. This
+    # attribute has a max length of 25 characters.
     # @return [String]
     attr_accessor :tax_code
 
@@ -130,6 +134,7 @@ module AdvancedBilling
     def self.nullables
       %w[
         trial_interval_unit
+        trial_type
         expiration_interval_unit
       ]
     end

data/lib/advanced_billing/models/create_payment_profile.rb

@@ -9,15 +9,15 @@ module AdvancedBilling
     SKIP = Object.new
     private_constant :SKIP
 
-    # Token received after sending billing informations using chargify.js.
+    # Token received after sending billing information using chargify.js.
     # @return [String]
     attr_accessor :chargify_token
 
-    # Token received after sending billing informations using chargify.js.
+    # Token received after sending billing information using chargify.js.
     # @return [Integer]
     attr_accessor :id
 
-    # Token received after sending billing informations using chargify.js.
+    # Token received after sending billing information using chargify.js.
     # @return [PaymentType]
     attr_accessor :payment_type
 
@@ -81,9 +81,9 @@ module AdvancedBilling
     # The credit card or bank account billing address country, required in
     # [ISO_3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2)
     # format (i.e. “US”). This value is merely passed through to the payment
-    # gateway. Some gateways require country codes in a specific format. Please
-    # check your gateway’s documentation. If creating an ACH subscription, only
-    # US is supported at this time.
+    # gateway. Some gateways require country codes in a specific format. Check
+    # your gateway’s documentation. If creating an ACH subscription, only US is
+    # supported at this time.
     # @return [String]
     attr_accessor :billing_country
 

data/lib/advanced_billing/models/create_prepayment_method.rb

@@ -40,5 +40,24 @@ module AdvancedBilling
 
       CREATE_PREPAYMENT_METHOD.include?(value)
     end
+
+    def self.from_value(value, default_value = CHECK)
+      return default_value if value.nil?
+
+      str = value.to_s.strip
+
+      case str.downcase
+      when 'check' then CHECK
+      when 'cash' then CASH
+      when 'money_order' then MONEY_ORDER
+      when 'ach' then ACH
+      when 'paypal_account' then PAYPAL_ACCOUNT
+      when 'credit_card' then CREDIT_CARD
+      when 'credit_card_on_file' then CREDIT_CARD_ON_FILE
+      when 'other' then OTHER
+      else
+        default_value
+      end
+    end
   end
 end

data/lib/advanced_billing/models/create_product_price_point.rb

@@ -47,9 +47,13 @@ module AdvancedBilling
     # @return [IntervalUnit]
     attr_accessor :trial_interval_unit
 
-    # A string representing the trial interval unit for this product price
-    # point, either month or day
-    # @return [String]
+    # Indicates how a trial is handled when the trail period ends and there is
+    # no credit card on file. For `no_obligation`, the subscription transitions
+    # to a Trial Ended state. Maxio will not send any emails or statements. For
+    # `payment_expected`, the subscription transitions to a Past Due state.
+    # Maxio will send normal dunning emails and statements according to your
+    # other settings.
+    # @return [TrialType]
     attr_accessor :trial_type
 
     # The product price point initial charge, in integer cents
@@ -115,6 +119,7 @@ module AdvancedBilling
     # An array for nullable fields
     def self.nullables
       %w[
+        trial_type
         expiration_interval_unit
       ]
     end

data/lib/advanced_billing/models/create_signup_proforma_preview_include.rb

@@ -16,5 +16,11 @@ module AdvancedBilling
 
       CREATE_SIGNUP_PROFORMA_PREVIEW_INCLUDE.include?(value)
     end
+
+    def self.from_value(value, default_value = NEXT_PROFORMA_INVOICE)
+      return default_value if value.nil?
+
+      default_value
+    end
   end
 end