orb-billing 0.2.0 → 0.3.0

data/rbi/lib/orb/models/credit_note.rbi

@@ -102,21 +102,34 @@ module Orb
           .returns(T.attached_class)
       end
       def self.new(
+        # The Orb id of this credit note.
         id:,
+        # The creation time of the resource in Orb.
         created_at:,
+        # The unique identifier for credit notes.
         credit_note_number:,
+        # A URL to a PDF of the credit note.
         credit_note_pdf:,
         customer:,
+        # The id of the invoice resource that this credit note is applied to.
         invoice_id:,
+        # All of the line items associated with this credit note.
         line_items:,
+        # The maximum amount applied on the original invoice
         maximum_amount_adjustment:,
+        # An optional memo supplied on the credit note.
         memo:,
+        # Any credited amount from the applied minimum on the invoice.
         minimum_amount_refunded:,
         reason:,
+        # The total prior to any creditable invoice-level discounts or minimums.
         subtotal:,
+        # The total including creditable invoice-level discounts or minimums, and tax.
         total:,
         type:,
+        # The time at which the credit note was voided in Orb, if applicable.
         voided_at:,
+        # Any discounts applied on the original invoice.
         discounts: nil
       ); end
       sig do
@@ -210,8 +223,24 @@ module Orb
           )
             .returns(T.attached_class)
         end
-        def self.new(id:, amount:, item_id:, name:, quantity:, subtotal:, tax_amounts:, discounts: nil); end
-
+        def self.new(
+          # The Orb id of this resource.
+          id:,
+          # The amount of the line item, including any line item minimums and discounts.
+          amount:,
+          # The id of the item associated with this line item.
+          item_id:,
+          # The name of the corresponding invoice line item.
+          name:,
+          # An optional quantity credited.
+          quantity:,
+          # The amount of the line item, excluding any line item minimums and discounts.
+          subtotal:,
+          # Any tax amounts applied onto the line item.
+          tax_amounts:,
+          # Any line item discounts from the invoice's line item.
+          discounts: nil
+        ); end
         sig do
           override
             .returns(
@@ -246,8 +275,14 @@ module Orb
             params(amount: String, tax_rate_description: String, tax_rate_percentage: T.nilable(String))
               .returns(T.attached_class)
           end
-          def self.new(amount:, tax_rate_description:, tax_rate_percentage:); end
-
+          def self.new(
+            # The amount of additional tax incurred by this tax rate.
+            amount:,
+            # The human-readable description of the applied tax rate.
+            tax_rate_description:,
+            # The tax rate percentage, out of 100.
+            tax_rate_percentage:
+          ); end
           sig do
             override.returns(
               {
@@ -323,8 +358,7 @@ module Orb
             extend Orb::Internal::Type::Enum
 
             TaggedSymbol = T.type_alias { T.all(Symbol, Orb::Models::CreditNote::LineItem::Discount::DiscountType) }
-            OrSymbol =
-              T.type_alias { T.any(Symbol, String, Orb::Models::CreditNote::LineItem::Discount::DiscountType::TaggedSymbol) }
+            OrSymbol = T.type_alias { T.any(Symbol, String) }
 
             PERCENTAGE = T.let(:percentage, Orb::Models::CreditNote::LineItem::Discount::DiscountType::TaggedSymbol)
             AMOUNT = T.let(:amount, Orb::Models::CreditNote::LineItem::Discount::DiscountType::TaggedSymbol)
@@ -392,8 +426,7 @@ module Orb
 
           TaggedSymbol =
             T.type_alias { T.all(Symbol, Orb::Models::CreditNote::MaximumAmountAdjustment::DiscountType) }
-          OrSymbol =
-            T.type_alias { T.any(Symbol, String, Orb::Models::CreditNote::MaximumAmountAdjustment::DiscountType::TaggedSymbol) }
+          OrSymbol = T.type_alias { T.any(Symbol, String) }
 
           PERCENTAGE =
             T.let(:percentage, Orb::Models::CreditNote::MaximumAmountAdjustment::DiscountType::TaggedSymbol)
@@ -421,7 +454,7 @@ module Orb
         extend Orb::Internal::Type::Enum
 
         TaggedSymbol = T.type_alias { T.all(Symbol, Orb::Models::CreditNote::Reason) }
-        OrSymbol = T.type_alias { T.any(Symbol, String, Orb::Models::CreditNote::Reason::TaggedSymbol) }
+        OrSymbol = T.type_alias { T.any(Symbol, String) }
 
         DUPLICATE = T.let(:Duplicate, Orb::Models::CreditNote::Reason::TaggedSymbol)
         FRAUDULENT = T.let(:Fraudulent, Orb::Models::CreditNote::Reason::TaggedSymbol)
@@ -436,7 +469,7 @@ module Orb
         extend Orb::Internal::Type::Enum
 
         TaggedSymbol = T.type_alias { T.all(Symbol, Orb::Models::CreditNote::Type) }
-        OrSymbol = T.type_alias { T.any(Symbol, String, Orb::Models::CreditNote::Type::TaggedSymbol) }
+        OrSymbol = T.type_alias { T.any(Symbol, String) }
 
         REFUND = T.let(:refund, Orb::Models::CreditNote::Type::TaggedSymbol)
         ADJUSTMENT = T.let(:adjustment, Orb::Models::CreditNote::Type::TaggedSymbol)
@@ -498,8 +531,7 @@ module Orb
           extend Orb::Internal::Type::Enum
 
           TaggedSymbol = T.type_alias { T.all(Symbol, Orb::Models::CreditNote::Discount::DiscountType) }
-          OrSymbol =
-            T.type_alias { T.any(Symbol, String, Orb::Models::CreditNote::Discount::DiscountType::TaggedSymbol) }
+          OrSymbol = T.type_alias { T.any(Symbol, String) }
 
           PERCENTAGE = T.let(:percentage, Orb::Models::CreditNote::Discount::DiscountType::TaggedSymbol)
 

data/rbi/lib/orb/models/credit_note_create_params.rbi

@@ -26,8 +26,14 @@ module Orb
         )
           .returns(T.attached_class)
       end
-      def self.new(line_items:, memo: nil, reason: nil, request_options: {}); end
-
+      def self.new(
+        line_items:,
+        # An optional memo to attach to the credit note.
+        memo: nil,
+        # An optional reason for the credit note.
+        reason: nil,
+        request_options: {}
+      ); end
       sig do
         override
           .returns(
@@ -51,8 +57,12 @@ module Orb
         attr_accessor :invoice_line_item_id
 
         sig { params(amount: String, invoice_line_item_id: String).returns(T.attached_class) }
-        def self.new(amount:, invoice_line_item_id:); end
-
+        def self.new(
+          # The total amount in the invoice's currency to credit this line item.
+          amount:,
+          # The ID of the line item to credit.
+          invoice_line_item_id:
+        ); end
         sig { override.returns({amount: String, invoice_line_item_id: String}) }
         def to_hash; end
       end
@@ -62,8 +72,7 @@ module Orb
         extend Orb::Internal::Type::Enum
 
         TaggedSymbol = T.type_alias { T.all(Symbol, Orb::Models::CreditNoteCreateParams::Reason) }
-        OrSymbol =
-          T.type_alias { T.any(Symbol, String, Orb::Models::CreditNoteCreateParams::Reason::TaggedSymbol) }
+        OrSymbol = T.type_alias { T.any(Symbol, String) }
 
         DUPLICATE = T.let(:duplicate, Orb::Models::CreditNoteCreateParams::Reason::TaggedSymbol)
         FRAUDULENT = T.let(:fraudulent, Orb::Models::CreditNoteCreateParams::Reason::TaggedSymbol)

data/rbi/lib/orb/models/credit_note_list_params.rbi

@@ -47,7 +47,10 @@ module Orb
         created_at_gte: nil,
         created_at_lt: nil,
         created_at_lte: nil,
+        # Cursor for pagination. This can be populated by the `next_cursor` value returned
+        # from the initial request.
         cursor: nil,
+        # The number of items to fetch. Defaults to 20.
         limit: nil,
         request_options: {}
       ); end

data/rbi/lib/orb/models/customer.rbi

@@ -278,22 +278,148 @@ module Orb
         id:,
         additional_emails:,
         auto_collection:,
+        # The customer's current balance in their currency.
         balance:,
         billing_address:,
         created_at:,
         currency:,
+        # A valid customer email, to be used for notifications. When Orb triggers payment
+        # through a payment gateway, this email will be used for any automatically issued
+        # receipts.
         email:,
         email_delivery:,
         exempt_from_automated_tax:,
+        # An optional user-defined ID for this customer resource, used throughout the
+        # system as an alias for this Customer. Use this field to identify a customer by
+        # an existing identifier in your system.
         external_customer_id:,
+        # The hierarchical relationships for this customer.
         hierarchy:,
+        # User specified key-value pairs for the resource. If not present, this defaults
+        # to an empty dictionary. Individual keys can be removed by setting the value to
+        # `null`, and the entire metadata mapping can be cleared by setting `metadata` to
+        # `null`.
         metadata:,
+        # The full name of the customer
         name:,
+        # This is used for creating charges or invoices in an external system via Orb.
+        # When not in test mode, the connection must first be configured in the Orb
+        # webapp.
         payment_provider:,
+        # The ID of this customer in an external payments solution, such as Stripe. This
+        # is used for creating charges or invoices in the external system via Orb.
         payment_provider_id:,
         portal_url:,
         shipping_address:,
+        # Tax IDs are commonly required to be displayed on customer invoices, which are
+        # added to the headers of invoices.
+        #
+        # ### Supported Tax ID Countries and Types
+        #
+        # | Country              | Type         | Description                                                                                             |
+        # | -------------------- | ------------ | ------------------------------------------------------------------------------------------------------- |
+        # | Andorra              | `ad_nrt`     | Andorran NRT Number                                                                                     |
+        # | Argentina            | `ar_cuit`    | Argentinian Tax ID Number                                                                               |
+        # | Australia            | `au_abn`     | Australian Business Number (AU ABN)                                                                     |
+        # | Australia            | `au_arn`     | Australian Taxation Office Reference Number                                                             |
+        # | Austria              | `eu_vat`     | European VAT Number                                                                                     |
+        # | Bahrain              | `bh_vat`     | Bahraini VAT Number                                                                                     |
+        # | Belgium              | `eu_vat`     | European VAT Number                                                                                     |
+        # | Bolivia              | `bo_tin`     | Bolivian Tax ID                                                                                         |
+        # | Brazil               | `br_cnpj`    | Brazilian CNPJ Number                                                                                   |
+        # | Brazil               | `br_cpf`     | Brazilian CPF Number                                                                                    |
+        # | Bulgaria             | `bg_uic`     | Bulgaria Unified Identification Code                                                                    |
+        # | Bulgaria             | `eu_vat`     | European VAT Number                                                                                     |
+        # | Canada               | `ca_bn`      | Canadian BN                                                                                             |
+        # | Canada               | `ca_gst_hst` | Canadian GST/HST Number                                                                                 |
+        # | Canada               | `ca_pst_bc`  | Canadian PST Number (British Columbia)                                                                  |
+        # | Canada               | `ca_pst_mb`  | Canadian PST Number (Manitoba)                                                                          |
+        # | Canada               | `ca_pst_sk`  | Canadian PST Number (Saskatchewan)                                                                      |
+        # | Canada               | `ca_qst`     | Canadian QST Number (Québec)                                                                            |
+        # | Chile                | `cl_tin`     | Chilean TIN                                                                                             |
+        # | China                | `cn_tin`     | Chinese Tax ID                                                                                          |
+        # | Colombia             | `co_nit`     | Colombian NIT Number                                                                                    |
+        # | Costa Rica           | `cr_tin`     | Costa Rican Tax ID                                                                                      |
+        # | Croatia              | `eu_vat`     | European VAT Number                                                                                     |
+        # | Cyprus               | `eu_vat`     | European VAT Number                                                                                     |
+        # | Czech Republic       | `eu_vat`     | European VAT Number                                                                                     |
+        # | Denmark              | `eu_vat`     | European VAT Number                                                                                     |
+        # | Dominican Republic   | `do_rcn`     | Dominican RCN Number                                                                                    |
+        # | Ecuador              | `ec_ruc`     | Ecuadorian RUC Number                                                                                   |
+        # | Egypt                | `eg_tin`     | Egyptian Tax Identification Number                                                                      |
+        # | El Salvador          | `sv_nit`     | El Salvadorian NIT Number                                                                               |
+        # | Estonia              | `eu_vat`     | European VAT Number                                                                                     |
+        # | EU                   | `eu_oss_vat` | European One Stop Shop VAT Number for non-Union scheme                                                  |
+        # | Finland              | `eu_vat`     | European VAT Number                                                                                     |
+        # | France               | `eu_vat`     | European VAT Number                                                                                     |
+        # | Georgia              | `ge_vat`     | Georgian VAT                                                                                            |
+        # | Germany              | `eu_vat`     | European VAT Number                                                                                     |
+        # | Greece               | `eu_vat`     | European VAT Number                                                                                     |
+        # | Hong Kong            | `hk_br`      | Hong Kong BR Number                                                                                     |
+        # | Hungary              | `eu_vat`     | European VAT Number                                                                                     |
+        # | Hungary              | `hu_tin`     | Hungary Tax Number (adószám)                                                                            |
+        # | Iceland              | `is_vat`     | Icelandic VAT                                                                                           |
+        # | India                | `in_gst`     | Indian GST Number                                                                                       |
+        # | Indonesia            | `id_npwp`    | Indonesian NPWP Number                                                                                  |
+        # | Ireland              | `eu_vat`     | European VAT Number                                                                                     |
+        # | Israel               | `il_vat`     | Israel VAT                                                                                              |
+        # | Italy                | `eu_vat`     | European VAT Number                                                                                     |
+        # | Japan                | `jp_cn`      | Japanese Corporate Number (_Hōjin Bangō_)                                                               |
+        # | Japan                | `jp_rn`      | Japanese Registered Foreign Businesses' Registration Number (_Tōroku Kokugai Jigyōsha no Tōroku Bangō_) |
+        # | Japan                | `jp_trn`     | Japanese Tax Registration Number (_Tōroku Bangō_)                                                       |
+        # | Kazakhstan           | `kz_bin`     | Kazakhstani Business Identification Number                                                              |
+        # | Kenya                | `ke_pin`     | Kenya Revenue Authority Personal Identification Number                                                  |
+        # | Latvia               | `eu_vat`     | European VAT Number                                                                                     |
+        # | Liechtenstein        | `li_uid`     | Liechtensteinian UID Number                                                                             |
+        # | Lithuania            | `eu_vat`     | European VAT Number                                                                                     |
+        # | Luxembourg           | `eu_vat`     | European VAT Number                                                                                     |
+        # | Malaysia             | `my_frp`     | Malaysian FRP Number                                                                                    |
+        # | Malaysia             | `my_itn`     | Malaysian ITN                                                                                           |
+        # | Malaysia             | `my_sst`     | Malaysian SST Number                                                                                    |
+        # | Malta                | `eu_vat `    | European VAT Number                                                                                     |
+        # | Mexico               | `mx_rfc`     | Mexican RFC Number                                                                                      |
+        # | Netherlands          | `eu_vat`     | European VAT Number                                                                                     |
+        # | New Zealand          | `nz_gst`     | New Zealand GST Number                                                                                  |
+        # | Nigeria              | `ng_tin`     | Nigerian Tax Identification Number                                                                      |
+        # | Norway               | `no_vat`     | Norwegian VAT Number                                                                                    |
+        # | Norway               | `no_voec`    | Norwegian VAT on e-commerce Number                                                                      |
+        # | Oman                 | `om_vat`     | Omani VAT Number                                                                                        |
+        # | Peru                 | `pe_ruc`     | Peruvian RUC Number                                                                                     |
+        # | Philippines          | `ph_tin `    | Philippines Tax Identification Number                                                                   |
+        # | Poland               | `eu_vat`     | European VAT Number                                                                                     |
+        # | Portugal             | `eu_vat`     | European VAT Number                                                                                     |
+        # | Romania              | `eu_vat`     | European VAT Number                                                                                     |
+        # | Romania              | `ro_tin`     | Romanian Tax ID Number                                                                                  |
+        # | Russia               | `ru_inn`     | Russian INN                                                                                             |
+        # | Russia               | `ru_kpp`     | Russian KPP                                                                                             |
+        # | Saudi Arabia         | `sa_vat`     | Saudi Arabia VAT                                                                                        |
+        # | Serbia               | `rs_pib`     | Serbian PIB Number                                                                                      |
+        # | Singapore            | `sg_gst`     | Singaporean GST                                                                                         |
+        # | Singapore            | `sg_uen`     | Singaporean UEN                                                                                         |
+        # | Slovakia             | `eu_vat`     | European VAT Number                                                                                     |
+        # | Slovenia             | `eu_vat`     | European VAT Number                                                                                     |
+        # | Slovenia             | `si_tin`     | Slovenia Tax Number (davčna številka)                                                                   |
+        # | South Africa         | `za_vat`     | South African VAT Number                                                                                |
+        # | South Korea          | `kr_brn`     | Korean BRN                                                                                              |
+        # | Spain                | `es_cif`     | Spanish NIF Number (previously Spanish CIF Number)                                                      |
+        # | Spain                | `eu_vat`     | European VAT Number                                                                                     |
+        # | Sweden               | `eu_vat`     | European VAT Number                                                                                     |
+        # | Switzerland          | `ch_vat`     | Switzerland VAT Number                                                                                  |
+        # | Taiwan               | `tw_vat`     | Taiwanese VAT                                                                                           |
+        # | Thailand             | `th_vat`     | Thai VAT                                                                                                |
+        # | Turkey               | `tr_tin`     | Turkish Tax Identification Number                                                                       |
+        # | Ukraine              | `ua_vat`     | Ukrainian VAT                                                                                           |
+        # | United Arab Emirates | `ae_trn`     | United Arab Emirates TRN                                                                                |
+        # | United Kingdom       | `eu_vat`     | Northern Ireland VAT Number                                                                             |
+        # | United Kingdom       | `gb_vat`     | United Kingdom VAT Number                                                                               |
+        # | United States        | `us_ein`     | United States EIN                                                                                       |
+        # | Uruguay              | `uy_ruc`     | Uruguayan RUC Number                                                                                    |
+        # | Venezuela            | `ve_rif`     | Venezuelan RIF Number                                                                                   |
+        # | Vietnam              | `vn_tin`     | Vietnamese Tax ID Number                                                                                |
         tax_id:,
+        # A timezone identifier from the IANA timezone database, such as
+        # "America/Los_Angeles". This "defaults to your account's timezone if not set.
+        # This cannot be changed after customer creation.
         timezone:,
         accounting_sync_configuration: nil,
         reporting_configuration: nil
@@ -444,7 +570,7 @@ module Orb
         extend Orb::Internal::Type::Enum
 
         TaggedSymbol = T.type_alias { T.all(Symbol, Orb::Models::Customer::PaymentProvider) }
-        OrSymbol = T.type_alias { T.any(Symbol, String, Orb::Models::Customer::PaymentProvider::TaggedSymbol) }
+        OrSymbol = T.type_alias { T.any(Symbol, String) }
 
         QUICKBOOKS = T.let(:quickbooks, Orb::Models::Customer::PaymentProvider::TaggedSymbol)
         BILL_COM = T.let(:"bill.com", Orb::Models::Customer::PaymentProvider::TaggedSymbol)
@@ -645,7 +771,7 @@ module Orb
           extend Orb::Internal::Type::Enum
 
           TaggedSymbol = T.type_alias { T.all(Symbol, Orb::Models::Customer::TaxID::Country) }
-          OrSymbol = T.type_alias { T.any(Symbol, String, Orb::Models::Customer::TaxID::Country::TaggedSymbol) }
+          OrSymbol = T.type_alias { T.any(Symbol, String) }
 
           AD = T.let(:AD, Orb::Models::Customer::TaxID::Country::TaggedSymbol)
           AE = T.let(:AE, Orb::Models::Customer::TaxID::Country::TaggedSymbol)
@@ -734,7 +860,7 @@ module Orb
           extend Orb::Internal::Type::Enum
 
           TaggedSymbol = T.type_alias { T.all(Symbol, Orb::Models::Customer::TaxID::Type) }
-          OrSymbol = T.type_alias { T.any(Symbol, String, Orb::Models::Customer::TaxID::Type::TaggedSymbol) }
+          OrSymbol = T.type_alias { T.any(Symbol, String) }
 
           AD_NRT = T.let(:ad_nrt, Orb::Models::Customer::TaxID::Type::TaggedSymbol)
           AE_TRN = T.let(:ae_trn, Orb::Models::Customer::TaxID::Type::TaggedSymbol)
@@ -876,14 +1002,7 @@ module Orb
 
             TaggedSymbol =
               T.type_alias { T.all(Symbol, Orb::Models::Customer::AccountingSyncConfiguration::AccountingProvider::ProviderType) }
-            OrSymbol =
-              T.type_alias do
-                T.any(
-                  Symbol,
-                  String,
-                  Orb::Models::Customer::AccountingSyncConfiguration::AccountingProvider::ProviderType::TaggedSymbol
-                )
-              end
+            OrSymbol = T.type_alias { T.any(Symbol, String) }
 
             QUICKBOOKS =
               T.let(

data/rbi/lib/orb/models/customer_create_params.rbi

@@ -272,23 +272,154 @@ module Orb
           .returns(T.attached_class)
       end
       def self.new(
+        # A valid customer email, to be used for notifications. When Orb triggers payment
+        # through a payment gateway, this email will be used for any automatically issued
+        # receipts.
         email:,
+        # The full name of the customer
         name:,
         accounting_sync_configuration: nil,
+        # Additional email addresses for this customer. If populated, these email
+        # addresses will be CC'd for customer communications.
         additional_emails: nil,
+        # Used to determine if invoices for this customer will automatically attempt to
+        # charge a saved payment method, if available. This parameter defaults to `True`
+        # when a payment provider is provided on customer creation.
         auto_collection: nil,
         billing_address: nil,
+        # An ISO 4217 currency string used for the customer's invoices and balance. If not
+        # set at creation time, will be set at subscription creation time.
         currency: nil,
         email_delivery: nil,
+        # An optional user-defined ID for this customer resource, used throughout the
+        # system as an alias for this Customer. Use this field to identify a customer by
+        # an existing identifier in your system.
         external_customer_id: nil,
+        # The hierarchical relationships for this customer.
         hierarchy: nil,
+        # User-specified key/value pairs for the resource. Individual keys can be removed
+        # by setting the value to `null`, and the entire metadata mapping can be cleared
+        # by setting `metadata` to `null`.
         metadata: nil,
+        # This is used for creating charges or invoices in an external system via Orb.
+        # When not in test mode, the connection must first be configured in the Orb
+        # webapp.
         payment_provider: nil,
+        # The ID of this customer in an external payments solution, such as Stripe. This
+        # is used for creating charges or invoices in the external system via Orb.
         payment_provider_id: nil,
         reporting_configuration: nil,
         shipping_address: nil,
         tax_configuration: nil,
+        # Tax IDs are commonly required to be displayed on customer invoices, which are
+        # added to the headers of invoices.
+        #
+        # ### Supported Tax ID Countries and Types
+        #
+        # | Country              | Type         | Description                                                                                             |
+        # | -------------------- | ------------ | ------------------------------------------------------------------------------------------------------- |
+        # | Andorra              | `ad_nrt`     | Andorran NRT Number                                                                                     |
+        # | Argentina            | `ar_cuit`    | Argentinian Tax ID Number                                                                               |
+        # | Australia            | `au_abn`     | Australian Business Number (AU ABN)                                                                     |
+        # | Australia            | `au_arn`     | Australian Taxation Office Reference Number                                                             |
+        # | Austria              | `eu_vat`     | European VAT Number                                                                                     |
+        # | Bahrain              | `bh_vat`     | Bahraini VAT Number                                                                                     |
+        # | Belgium              | `eu_vat`     | European VAT Number                                                                                     |
+        # | Bolivia              | `bo_tin`     | Bolivian Tax ID                                                                                         |
+        # | Brazil               | `br_cnpj`    | Brazilian CNPJ Number                                                                                   |
+        # | Brazil               | `br_cpf`     | Brazilian CPF Number                                                                                    |
+        # | Bulgaria             | `bg_uic`     | Bulgaria Unified Identification Code                                                                    |
+        # | Bulgaria             | `eu_vat`     | European VAT Number                                                                                     |
+        # | Canada               | `ca_bn`      | Canadian BN                                                                                             |
+        # | Canada               | `ca_gst_hst` | Canadian GST/HST Number                                                                                 |
+        # | Canada               | `ca_pst_bc`  | Canadian PST Number (British Columbia)                                                                  |
+        # | Canada               | `ca_pst_mb`  | Canadian PST Number (Manitoba)                                                                          |
+        # | Canada               | `ca_pst_sk`  | Canadian PST Number (Saskatchewan)                                                                      |
+        # | Canada               | `ca_qst`     | Canadian QST Number (Québec)                                                                            |
+        # | Chile                | `cl_tin`     | Chilean TIN                                                                                             |
+        # | China                | `cn_tin`     | Chinese Tax ID                                                                                          |
+        # | Colombia             | `co_nit`     | Colombian NIT Number                                                                                    |
+        # | Costa Rica           | `cr_tin`     | Costa Rican Tax ID                                                                                      |
+        # | Croatia              | `eu_vat`     | European VAT Number                                                                                     |
+        # | Cyprus               | `eu_vat`     | European VAT Number                                                                                     |
+        # | Czech Republic       | `eu_vat`     | European VAT Number                                                                                     |
+        # | Denmark              | `eu_vat`     | European VAT Number                                                                                     |
+        # | Dominican Republic   | `do_rcn`     | Dominican RCN Number                                                                                    |
+        # | Ecuador              | `ec_ruc`     | Ecuadorian RUC Number                                                                                   |
+        # | Egypt                | `eg_tin`     | Egyptian Tax Identification Number                                                                      |
+        # | El Salvador          | `sv_nit`     | El Salvadorian NIT Number                                                                               |
+        # | Estonia              | `eu_vat`     | European VAT Number                                                                                     |
+        # | EU                   | `eu_oss_vat` | European One Stop Shop VAT Number for non-Union scheme                                                  |
+        # | Finland              | `eu_vat`     | European VAT Number                                                                                     |
+        # | France               | `eu_vat`     | European VAT Number                                                                                     |
+        # | Georgia              | `ge_vat`     | Georgian VAT                                                                                            |
+        # | Germany              | `eu_vat`     | European VAT Number                                                                                     |
+        # | Greece               | `eu_vat`     | European VAT Number                                                                                     |
+        # | Hong Kong            | `hk_br`      | Hong Kong BR Number                                                                                     |
+        # | Hungary              | `eu_vat`     | European VAT Number                                                                                     |
+        # | Hungary              | `hu_tin`     | Hungary Tax Number (adószám)                                                                            |
+        # | Iceland              | `is_vat`     | Icelandic VAT                                                                                           |
+        # | India                | `in_gst`     | Indian GST Number                                                                                       |
+        # | Indonesia            | `id_npwp`    | Indonesian NPWP Number                                                                                  |
+        # | Ireland              | `eu_vat`     | European VAT Number                                                                                     |
+        # | Israel               | `il_vat`     | Israel VAT                                                                                              |
+        # | Italy                | `eu_vat`     | European VAT Number                                                                                     |
+        # | Japan                | `jp_cn`      | Japanese Corporate Number (_Hōjin Bangō_)                                                               |
+        # | Japan                | `jp_rn`      | Japanese Registered Foreign Businesses' Registration Number (_Tōroku Kokugai Jigyōsha no Tōroku Bangō_) |
+        # | Japan                | `jp_trn`     | Japanese Tax Registration Number (_Tōroku Bangō_)                                                       |
+        # | Kazakhstan           | `kz_bin`     | Kazakhstani Business Identification Number                                                              |
+        # | Kenya                | `ke_pin`     | Kenya Revenue Authority Personal Identification Number                                                  |
+        # | Latvia               | `eu_vat`     | European VAT Number                                                                                     |
+        # | Liechtenstein        | `li_uid`     | Liechtensteinian UID Number                                                                             |
+        # | Lithuania            | `eu_vat`     | European VAT Number                                                                                     |
+        # | Luxembourg           | `eu_vat`     | European VAT Number                                                                                     |
+        # | Malaysia             | `my_frp`     | Malaysian FRP Number                                                                                    |
+        # | Malaysia             | `my_itn`     | Malaysian ITN                                                                                           |
+        # | Malaysia             | `my_sst`     | Malaysian SST Number                                                                                    |
+        # | Malta                | `eu_vat `    | European VAT Number                                                                                     |
+        # | Mexico               | `mx_rfc`     | Mexican RFC Number                                                                                      |
+        # | Netherlands          | `eu_vat`     | European VAT Number                                                                                     |
+        # | New Zealand          | `nz_gst`     | New Zealand GST Number                                                                                  |
+        # | Nigeria              | `ng_tin`     | Nigerian Tax Identification Number                                                                      |
+        # | Norway               | `no_vat`     | Norwegian VAT Number                                                                                    |
+        # | Norway               | `no_voec`    | Norwegian VAT on e-commerce Number                                                                      |
+        # | Oman                 | `om_vat`     | Omani VAT Number                                                                                        |
+        # | Peru                 | `pe_ruc`     | Peruvian RUC Number                                                                                     |
+        # | Philippines          | `ph_tin `    | Philippines Tax Identification Number                                                                   |
+        # | Poland               | `eu_vat`     | European VAT Number                                                                                     |
+        # | Portugal             | `eu_vat`     | European VAT Number                                                                                     |
+        # | Romania              | `eu_vat`     | European VAT Number                                                                                     |
+        # | Romania              | `ro_tin`     | Romanian Tax ID Number                                                                                  |
+        # | Russia               | `ru_inn`     | Russian INN                                                                                             |
+        # | Russia               | `ru_kpp`     | Russian KPP                                                                                             |
+        # | Saudi Arabia         | `sa_vat`     | Saudi Arabia VAT                                                                                        |
+        # | Serbia               | `rs_pib`     | Serbian PIB Number                                                                                      |
+        # | Singapore            | `sg_gst`     | Singaporean GST                                                                                         |
+        # | Singapore            | `sg_uen`     | Singaporean UEN                                                                                         |
+        # | Slovakia             | `eu_vat`     | European VAT Number                                                                                     |
+        # | Slovenia             | `eu_vat`     | European VAT Number                                                                                     |
+        # | Slovenia             | `si_tin`     | Slovenia Tax Number (davčna številka)                                                                   |
+        # | South Africa         | `za_vat`     | South African VAT Number                                                                                |
+        # | South Korea          | `kr_brn`     | Korean BRN                                                                                              |
+        # | Spain                | `es_cif`     | Spanish NIF Number (previously Spanish CIF Number)                                                      |
+        # | Spain                | `eu_vat`     | European VAT Number                                                                                     |
+        # | Sweden               | `eu_vat`     | European VAT Number                                                                                     |
+        # | Switzerland          | `ch_vat`     | Switzerland VAT Number                                                                                  |
+        # | Taiwan               | `tw_vat`     | Taiwanese VAT                                                                                           |
+        # | Thailand             | `th_vat`     | Thai VAT                                                                                                |
+        # | Turkey               | `tr_tin`     | Turkish Tax Identification Number                                                                       |
+        # | Ukraine              | `ua_vat`     | Ukrainian VAT                                                                                           |
+        # | United Arab Emirates | `ae_trn`     | United Arab Emirates TRN                                                                                |
+        # | United Kingdom       | `eu_vat`     | Northern Ireland VAT Number                                                                             |
+        # | United Kingdom       | `gb_vat`     | United Kingdom VAT Number                                                                               |
+        # | United States        | `us_ein`     | United States EIN                                                                                       |
+        # | Uruguay              | `uy_ruc`     | Uruguayan RUC Number                                                                                    |
+        # | Venezuela            | `ve_rif`     | Venezuelan RIF Number                                                                                   |
+        # | Vietnam              | `vn_tin`     | Vietnamese Tax ID Number                                                                                |
         tax_id: nil,
+        # A timezone identifier from the IANA timezone database, such as
+        # `"America/Los_Angeles"`. This defaults to your account's timezone if not set.
+        # This cannot be changed after customer creation.
         timezone: nil,
         request_options: {}
       ); end
@@ -445,8 +576,14 @@ module Orb
           params(child_customer_ids: T::Array[String], parent_customer_id: T.nilable(String))
             .returns(T.attached_class)
         end
-        def self.new(child_customer_ids: nil, parent_customer_id: nil); end
-
+        def self.new(
+          # A list of child customer IDs to add to the hierarchy. The desired child
+          # customers must not already be part of another hierarchy.
+          child_customer_ids: nil,
+          # The ID of the parent customer in the hierarchy. The desired parent customer must
+          # not be a child of another customer.
+          parent_customer_id: nil
+        ); end
         sig do
           override.returns({child_customer_ids: T::Array[String], parent_customer_id: T.nilable(String)})
         end
@@ -460,8 +597,7 @@ module Orb
         extend Orb::Internal::Type::Enum
 
         TaggedSymbol = T.type_alias { T.all(Symbol, Orb::Models::CustomerCreateParams::PaymentProvider) }
-        OrSymbol =
-          T.type_alias { T.any(Symbol, String, Orb::Models::CustomerCreateParams::PaymentProvider::TaggedSymbol) }
+        OrSymbol = T.type_alias { T.any(Symbol, String) }
 
         QUICKBOOKS = T.let(:quickbooks, Orb::Models::CustomerCreateParams::PaymentProvider::TaggedSymbol)
         BILL_COM = T.let(:"bill.com", Orb::Models::CustomerCreateParams::PaymentProvider::TaggedSymbol)
@@ -727,8 +863,7 @@ module Orb
           extend Orb::Internal::Type::Enum
 
           TaggedSymbol = T.type_alias { T.all(Symbol, Orb::Models::CustomerCreateParams::TaxID::Country) }
-          OrSymbol =
-            T.type_alias { T.any(Symbol, String, Orb::Models::CustomerCreateParams::TaxID::Country::TaggedSymbol) }
+          OrSymbol = T.type_alias { T.any(Symbol, String) }
 
           AD = T.let(:AD, Orb::Models::CustomerCreateParams::TaxID::Country::TaggedSymbol)
           AE = T.let(:AE, Orb::Models::CustomerCreateParams::TaxID::Country::TaggedSymbol)
@@ -817,8 +952,7 @@ module Orb
           extend Orb::Internal::Type::Enum
 
           TaggedSymbol = T.type_alias { T.all(Symbol, Orb::Models::CustomerCreateParams::TaxID::Type) }
-          OrSymbol =
-            T.type_alias { T.any(Symbol, String, Orb::Models::CustomerCreateParams::TaxID::Type::TaggedSymbol) }
+          OrSymbol = T.type_alias { T.any(Symbol, String) }
 
           AD_NRT = T.let(:ad_nrt, Orb::Models::CustomerCreateParams::TaxID::Type::TaggedSymbol)
           AE_TRN = T.let(:ae_trn, Orb::Models::CustomerCreateParams::TaxID::Type::TaggedSymbol)

data/rbi/lib/orb/models/customer_list_params.rbi

@@ -47,7 +47,10 @@ module Orb
         created_at_gte: nil,
         created_at_lt: nil,
         created_at_lte: nil,
+        # Cursor for pagination. This can be populated by the `next_cursor` value returned
+        # from the initial request.
         cursor: nil,
+        # The number of items to fetch. Defaults to 20.
         limit: nil,
         request_options: {}
       ); end