chargebee 2.63.0 → 2.65.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 296d2eccf7af2ab3d24e90fe64baa8496761a6785108b62c161fcd2c408f2e61
-  data.tar.gz: 973118c500afa122cdd08536a51fd68e82220be13ddb6dbb6724239bf64a841a
+  metadata.gz: 5b0b37c72eef916eaec5a8fa4f508a1a071056dc10798590bc892591f412b00b
+  data.tar.gz: caf64e0b250f35d66a60ec73223314cbed3c91297ba4b9880ce073f84e8db857
 SHA512:
-  metadata.gz: 6e1c0b75e91eb669dbc39baed6b5a9bc018b02c581bb2aeec8927891b82556fda02fa36d58c53560b67a35fd5b377bad4a5e09cd0ffeb7245610dd2964ad6a87
-  data.tar.gz: 75378fd389a1db7c9febff79334d7fc83ad8e151080cc9245c31c8f2fb552d836d2ec698a56c98c35d06530f5a7f8d6ee3b10e309ab5f6addb2ccfa311df99cc
+  metadata.gz: 56203ce39083b6363cb44fc81f321794fbef5e147071ea122a8d7e526016d761db4b7b93ff583fca190cba420362bd04ae3c9b2a3f9e35be8b49a62ecef70eec
+  data.tar.gz: 5aac867679984bc681374ed1752d1f2139c7f22a6f7653e4b1e2922886494218bb28b0071d69e30a3e9feaf7472fe0ea58a6513388878f68f1920645a882df81

data/CHANGELOG.md

@@ -1,3 +1,59 @@
+### v2.65.0 (2025-11-26)
+* * * 
+
+### New Resources: 
+* Einvoice has been added.
+* QuotedDeltaRamp has been added. 
+
+### New Attributes: 
+* line_items_next_offset has been added to CreditNote.
+* line_items_next_offset has been added to Invoice.
+* credit_lines has been added to SalesOrder.
+* billable_unit_price has been added to SalesOrder#LineItem.
+* billable_quantity has been added to SalesOrder#LineItem.
+* billable_amount has been added to SalesOrder#LineItem.
+
+### New Endpoint: 
+* move has been added to ItemPrice.
+
+### New Parameters: 
+* line_items_limit has been added to CreditNote#RetrieveRequest.
+* line_items_offset has been added to CreditNote#RetrieveRequest.
+* line_items_limit has been added to Invoice#RetrieveRequest.
+* line_items_offset has been added to Invoice#RetrieveRequest.
+* item_tiers has been added to Estimate#GiftSubscriptionForItemsRequest.
+* unit_price has been added to Estimate#SubscriptionItems#GiftSubscriptionForItemsRequest.
+* unit_price_in_decimal has been added to Estimate#SubscriptionItems#GiftSubscriptionForItemsRequest.
+* item_tiers has been added to Gift#CreateForItemsRequest.
+* meta_data has been added to Gift#CreateForItemsRequest.
+* unit_price has been added to Gift#SubscriptionItems#CreateForItemsRequest.
+* unit_price_in_decimal has been added to Gift#SubscriptionItems#CreateForItemsRequest.
+* item_tiers has been added to HostedPage#CheckoutGiftForItemsRequest.
+* unit_price has been added to HostedPage#SubscriptionItems#CheckoutGiftForItemsRequest.
+* unit_price_in_decimal has been added to HostedPage#SubscriptionItems#CheckoutGiftForItemsRequest.
+* auto_select_local_currency has been added to PricingPageSession#CreateForNewSubscriptionRequest.
+
+### New Enums: 
+* EZIDEBIT has been added to GatewayEnum.
+* BUSINESS_RULE has been added to EntityTypeEnum.
+* RULESET has been added to EntityTypeEnum.
+
+### v2.64.0 (2025-11-10)
+* * * 
+
+### Error Handling
+  - Added new `ForbiddenError` class that inherits from `Error`
+  - Enhanced `handle_for_error` method to detect and handle 403 status codes
+  - Provides clear error message: "Access forbidden. You do not have permission to access this resource."
+
+### Code Quality Improvements
+  - Renamed `lib/chargebee/nativeRequest.rb` → `lib/chargebee/native_request.rb` to follow Ruby naming conventions
+  - Refactored `handle_for_error` to return error objects instead of raising them inline (cleaner separation of concerns)
+  - Added YARD documentation for `handle_for_error` method
+
+### Testing
+  - Added comprehensive test coverage for 403 error scenarios
+
 ### v2.63.0 (2025-10-28)
 * * * 
 

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    chargebee (2.63.0)
+    chargebee (2.65.0)
       cgi (>= 0.1.0, < 1.0.0)
 
 GEM

data/chargebee.gemspec

@@ -4,8 +4,8 @@ Gem::Specification.new do |s|
   s.rubygems_version = '1.3.5'
   s.required_ruby_version = '>= 1.9.3'
   s.name              = 'chargebee'
-  s.version           = '2.63.0'
-  s.date              = '2025-10-28'
+  s.version           = '2.65.0'
+  s.date              = '2025-11-26'
   s.summary     = "Ruby client for Chargebee API."
   s.description = "Subscription Billing - Simple. Secure. Affordable. More details at www.chargebee.com."
   s.metadata = {
@@ -66,6 +66,7 @@ Gem::Specification.new do |s|
     lib/chargebee/models/differential_price.rb
     lib/chargebee/models/discount.rb
     lib/chargebee/models/download.rb
+    lib/chargebee/models/einvoice.rb
     lib/chargebee/models/entitlement.rb
     lib/chargebee/models/entitlement_override.rb
     lib/chargebee/models/estimate.rb
@@ -117,6 +118,7 @@ Gem::Specification.new do |s|
     lib/chargebee/models/quote.rb
     lib/chargebee/models/quote_line_group.rb
     lib/chargebee/models/quoted_charge.rb
+    lib/chargebee/models/quoted_delta_ramp.rb
     lib/chargebee/models/quoted_ramp.rb
     lib/chargebee/models/quoted_subscription.rb
     lib/chargebee/models/ramp.rb
@@ -140,7 +142,7 @@ Gem::Specification.new do |s|
     lib/chargebee/models/usage_file.rb
     lib/chargebee/models/virtual_bank_account.rb
     lib/chargebee/models/webhook_endpoint.rb
-    lib/chargebee/nativeRequest.rb
+    lib/chargebee/native_request.rb
     lib/chargebee/request.rb
     lib/chargebee/rest.rb
     lib/chargebee/result.rb

data/lib/chargebee/errors.rb

@@ -8,6 +8,8 @@ module ChargeBee
     end
   end
 
+  class ForbiddenError < Error; end
+
   class IOError < Error; end
 
   class APIError < Error

data/lib/chargebee/models/credit_note.rb

@@ -60,11 +60,11 @@ module ChargeBee
   attr_accessor :id, :customer_id, :subscription_id, :reference_invoice_id, :type, :reason_code,
   :status, :vat_number, :date, :price_type, :currency_code, :total, :amount_allocated, :amount_refunded,
   :amount_available, :refunded_at, :voided_at, :generated_at, :resource_version, :updated_at,
-  :channel, :sub_total, :sub_total_in_local_currency, :total_in_local_currency, :local_currency_code,
-  :round_off_amount, :fractional_correction, :line_items, :line_item_tiers, :line_item_discounts,
-  :line_item_taxes, :line_item_addresses, :discounts, :taxes, :tax_origin, :linked_refunds, :allocations,
-  :deleted, :tax_category, :local_currency_exchange_rate, :create_reason_code, :vat_number_prefix,
-  :business_entity_id, :shipping_address, :billing_address, :einvoice, :site_details_at_creation
+  :channel, :line_items_next_offset, :sub_total, :sub_total_in_local_currency, :total_in_local_currency,
+  :local_currency_code, :round_off_amount, :fractional_correction, :line_items, :line_item_tiers,
+  :line_item_discounts, :line_item_taxes, :line_item_addresses, :discounts, :taxes, :tax_origin,
+  :linked_refunds, :allocations, :deleted, :tax_category, :local_currency_exchange_rate, :create_reason_code,
+  :vat_number_prefix, :business_entity_id, :shipping_address, :billing_address, :einvoice, :site_details_at_creation
 
   # OPERATIONS
   #-----------

data/lib/chargebee/models/einvoice.rb

@@ -0,0 +1,10 @@
+module ChargeBee
+  class Einvoice < Model
+
+  attr_accessor :id, :reference_number, :status, :message
+
+  # OPERATIONS
+  #-----------
+
+  end # ~Einvoice
+end # ~ChargeBee

data/lib/chargebee/models/gift.rb

@@ -31,6 +31,7 @@ module ChargeBee
 
   def self.create_for_items(params, env=nil, headers={})
     jsonKeys = { 
+        :meta_data => 0,
         :additional_information => 1,
     }
     options = {

data/lib/chargebee/models/invoice.rb

@@ -94,13 +94,13 @@ module ChargeBee
   :currency_code, :local_currency_code, :tax, :sub_total, :sub_total_in_local_currency, :total,
   :total_in_local_currency, :amount_due, :amount_adjusted, :amount_paid, :paid_at, :write_off_amount,
   :credits_applied, :dunning_status, :next_retry_at, :voided_at, :resource_version, :updated_at,
-  :first_invoice, :new_sales_amount, :has_advance_charges, :term_finalized, :is_gifted, :generated_at,
-  :expected_payment_date, :amount_to_collect, :round_off_amount, :line_items, :line_item_tiers,
-  :line_item_discounts, :line_item_taxes, :line_item_credits, :line_item_addresses, :discounts,
-  :taxes, :tax_origin, :linked_payments, :reference_transactions, :dunning_attempts, :applied_credits,
-  :adjustment_credit_notes, :issued_credit_notes, :linked_orders, :notes, :shipping_address, :billing_address,
-  :statement_descriptor, :einvoice, :void_reason_code, :deleted, :tax_category, :vat_number_prefix,
-  :channel, :business_entity_id, :site_details_at_creation
+  :line_items_next_offset, :first_invoice, :new_sales_amount, :has_advance_charges, :term_finalized,
+  :is_gifted, :generated_at, :expected_payment_date, :amount_to_collect, :round_off_amount, :line_items,
+  :line_item_tiers, :line_item_discounts, :line_item_taxes, :line_item_credits, :line_item_addresses,
+  :discounts, :taxes, :tax_origin, :linked_payments, :reference_transactions, :dunning_attempts,
+  :applied_credits, :adjustment_credit_notes, :issued_credit_notes, :linked_orders, :notes, :shipping_address,
+  :billing_address, :statement_descriptor, :einvoice, :void_reason_code, :deleted, :tax_category,
+  :vat_number_prefix, :channel, :business_entity_id, :site_details_at_creation
 
   # OPERATIONS
   #-----------

data/lib/chargebee/models/item_price.rb

@@ -85,5 +85,14 @@ module ChargeBee
     Request.send('get', uri_path("item_prices",id.to_s,"applicable_item_prices"), params, env, headers,nil, false, jsonKeys, options)
   end
 
+  def self.move_item_price(id, params, env=nil, headers={})
+    jsonKeys = { 
+    }
+    options = {
+        :isIdempotent => true
+      }
+    Request.send('post', uri_path("item_prices",id.to_s,"move"), params, env, headers,nil, false, jsonKeys, options)
+  end
+
   end # ~ItemPrice
 end # ~ChargeBee

data/lib/chargebee/models/quoted_delta_ramp.rb

@@ -0,0 +1,14 @@
+module ChargeBee
+  class QuotedDeltaRamp < Model
+
+    class LineItem < Model
+      attr_accessor :item_level_discount_per_billing_cycle_in_decimal
+    end
+
+  attr_accessor :line_items
+
+  # OPERATIONS
+  #-----------
+
+  end # ~QuotedDeltaRamp
+end # ~ChargeBee

data/lib/chargebee/{nativeRequest.rb → native_request.rb}

@@ -167,26 +167,33 @@ module ChargeBee
       end
     end
 
+    # Handle errors returned by the ChargeBee API.
+    #
+    # @param rcode [Integer] HTTP status code.
+    # @param rbody [String] HTTP response body.
+    #
+    # @return [ChargeBee::Error] Appropriate ChargeBee error object.
     def self.handle_for_error(rcode, rbody)
       return Error.new("No response returned by ChargeBee API. HTTP status code: #{rcode}") if rcode == 204
+      return ForbiddenError.new("Access forbidden. You do not have permission to access this resource.") if rcode == 403
       begin
         error_obj = JSON.parse(rbody)
         error_obj = Util.symbolize_keys(error_obj)
       rescue Exception => e
-        raise Error.new("Error response not in JSON format. The http status code is #{rcode} \n #{rbody.inspect}", e)
+        return Error.new("Error response not in JSON format. The http status code is #{rcode} \n #{rbody.inspect}", e)
       end
-      type = error_obj[:type]
-      case type
+
+      case error_obj[:type]
       when "payment"
-        raise PaymentError.new(rcode, error_obj)
+        PaymentError.new(rcode, error_obj)
       when "operation_failed"
-        raise OperationFailedError.new(rcode, error_obj)
+        OperationFailedError.new(rcode, error_obj)
       when "invalid_request"
-        raise InvalidRequestError.new(rcode, error_obj)
+        InvalidRequestError.new(rcode, error_obj)
       when "ubb_batch_ingestion_invalid_request"
-        raise UbbBatchIngestionInvalidRequestError.new(rcode, error_obj)
+        UbbBatchIngestionInvalidRequestError.new(rcode, error_obj)
       else
-        raise APIError.new(rcode, error_obj)
+        APIError.new(rcode, error_obj)
       end
     end
 

data/lib/chargebee/result.rb

@@ -121,6 +121,11 @@ module ChargeBee
         return payment_schedule;
     end
 
+    def einvoice() 
+        einvoice = get(:einvoice, Einvoice);
+        return einvoice;
+    end
+
     def tax_withheld() 
         tax_withheld = get(:tax_withheld, TaxWithheld);
         return tax_withheld;
@@ -207,6 +212,12 @@ module ChargeBee
         return quoted_ramp;
     end
 
+    def quoted_delta_ramp() 
+        quoted_delta_ramp = get(:quoted_delta_ramp, QuotedDeltaRamp,
+        {:line_items => QuotedDeltaRamp::LineItem});
+        return quoted_delta_ramp;
+    end
+
     def billing_configuration() 
         billing_configuration = get(:billing_configuration, BillingConfiguration,
         {:billing_dates => BillingConfiguration::BillingDate});

data/lib/chargebee.rb

@@ -1,5 +1,5 @@
 require File.dirname(__FILE__) + '/chargebee/environment'
-require File.dirname(__FILE__) + '/chargebee/nativeRequest'
+require File.dirname(__FILE__) + '/chargebee/native_request'
 require File.dirname(__FILE__) + '/chargebee/util'
 require File.dirname(__FILE__) + '/chargebee/request'
 require File.dirname(__FILE__) + '/chargebee/result'
@@ -94,11 +94,13 @@ require File.dirname(__FILE__) + '/chargebee/models/omnichannel_one_time_order_i
 require File.dirname(__FILE__) + '/chargebee/models/personalized_offer'
 require File.dirname(__FILE__) + '/chargebee/models/offer_event'
 require File.dirname(__FILE__) + '/chargebee/models/offer_fulfillment'
+require File.dirname(__FILE__) + '/chargebee/models/quoted_delta_ramp'
+require File.dirname(__FILE__) + '/chargebee/models/einvoice'
 
 
 module ChargeBee
 
-  VERSION = '2.63.0'
+  VERSION = '2.65.0'
 
   @@default_env = nil
   @@verify_ca_certs = true

data/spec/chargebee/native_request_spec.rb

@@ -141,6 +141,19 @@ module ChargeBee
       end
     end
 
+    it "raises ForbiddenError for 403 status code" do
+      stub_request(:get, "https://dummy.chargebee.com/test").to_return(
+        body: "<html>\r\n<head><title>403 Forbidden</title></head>\r\n<body>\r\n<center><h1>403 Forbidden</h1></center>\r\n</body>\r\n</html>\r\n",
+        status: 403
+      )
+
+      expect {
+        NativeRequest.request(:get, "/test", env)
+      }.to raise_error(ForbiddenError) do |err|
+        expect(err.message).to eq("Access forbidden. You do not have permission to access this resource.")
+      end
+    end
+
     it "retries once on HTTP 503 and succeeds on second attempt" do
       stub_request(:get, "https://dummy.chargebee.com/test")
         .to_return({ status: 503, body: "temporary error" },

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: chargebee
 version: !ruby/object:Gem::Version
-  version: 2.63.0
+  version: 2.65.0
 platform: ruby
 authors:
 - Rajaraman S
@@ -9,7 +9,7 @@ authors:
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2025-10-28 00:00:00.000000000 Z
+date: 2025-11-26 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: cgi
@@ -107,6 +107,7 @@ files:
 - lib/chargebee/models/differential_price.rb
 - lib/chargebee/models/discount.rb
 - lib/chargebee/models/download.rb
+- lib/chargebee/models/einvoice.rb
 - lib/chargebee/models/entitlement.rb
 - lib/chargebee/models/entitlement_override.rb
 - lib/chargebee/models/estimate.rb
@@ -158,6 +159,7 @@ files:
 - lib/chargebee/models/quote.rb
 - lib/chargebee/models/quote_line_group.rb
 - lib/chargebee/models/quoted_charge.rb
+- lib/chargebee/models/quoted_delta_ramp.rb
 - lib/chargebee/models/quoted_ramp.rb
 - lib/chargebee/models/quoted_subscription.rb
 - lib/chargebee/models/ramp.rb
@@ -181,7 +183,7 @@ files:
 - lib/chargebee/models/usage_file.rb
 - lib/chargebee/models/virtual_bank_account.rb
 - lib/chargebee/models/webhook_endpoint.rb
-- lib/chargebee/nativeRequest.rb
+- lib/chargebee/native_request.rb
 - lib/chargebee/request.rb
 - lib/chargebee/rest.rb
 - lib/chargebee/result.rb