xero-ruby 1.1.0 → 5.0.0

data/lib/xero-ruby/models/accounting/contact.rb

@@ -1,12 +1,11 @@
 =begin
-#Accounting API
+#Xero Accounting API
 
 #No description provided (generated by Openapi Generator https://github.com/openapitools/openapi-generator)
 
-The version of the OpenAPI document: 2.1.3
 Contact: api@xero.com
 Generated by: https://openapi-generator.tech
-OpenAPI Generator version: 4.3.0
+OpenAPI Generator version: 4.3.1
 
 =end
 
@@ -14,119 +13,144 @@ require 'time'
 require 'date'
 
 module XeroRuby::Accounting
+  require 'bigdecimal'
+
   class Contact
     # Xero identifier
     attr_accessor :contact_id
-
+    
+    # ID for the destination of a merged contact. Only returned when using paging or when fetching a contact by ContactId or ContactNumber.
+    attr_accessor :merged_to_contact_id
+    
     # This can be updated via the API only i.e. This field is read only on the Xero contact screen, used to identify contacts in external systems (max length = 50). If the Contact Number is used, this is displayed as Contact Code in the Contacts UI in Xero.
     attr_accessor :contact_number
-
+    
     # A user defined account number. This can be updated via the API and the Xero UI (max length = 50)
     attr_accessor :account_number
-
+    
     # Current status of a contact – see contact status types
     attr_accessor :contact_status
-
+    ACTIVE ||= "ACTIVE".freeze
+    ARCHIVED ||= "ARCHIVED".freeze
+    GDPRREQUEST ||= "GDPRREQUEST".freeze
+    
     # Full name of contact/organisation (max length = 255)
     attr_accessor :name
-
+    
     # First name of contact person (max length = 255)
     attr_accessor :first_name
-
+    
     # Last name of contact person (max length = 255)
     attr_accessor :last_name
-
+    
+    # Company registration number (max length = 50)
+    attr_accessor :company_number
+    
     # Email address of contact person (umlauts not supported) (max length  = 255)
     attr_accessor :email_address
-
-    # Skype user name of contact
-    attr_accessor :skype_user_name
-
+    
     # See contact persons
     attr_accessor :contact_persons
-
+    
     # Bank account number of contact
     attr_accessor :bank_account_details
-
+    
     # Tax number of contact – this is also known as the ABN (Australia), GST Number (New Zealand), VAT Number (UK) or Tax ID Number (US and global) in the Xero UI depending on which regionalized version of Xero you are using (max length = 50)
     attr_accessor :tax_number
-
+    
     # The tax type from TaxRates
     attr_accessor :accounts_receivable_tax_type
-
+    
     # The tax type from TaxRates
     attr_accessor :accounts_payable_tax_type
-
+    
     # Store certain address types for a contact – see address types
     attr_accessor :addresses
-
+    
     # Store certain phone types for a contact – see phone types
     attr_accessor :phones
-
+    
     # true or false – Boolean that describes if a contact that has any AP  invoices entered against them. Cannot be set via PUT or POST – it is automatically set when an accounts payable invoice is generated against this contact.
     attr_accessor :is_supplier
-
+    
     # true or false – Boolean that describes if a contact has any AR invoices entered against them. Cannot be set via PUT or POST – it is automatically set when an accounts receivable invoice is generated against this contact.
     attr_accessor :is_customer
+    
+    # The default sales line amount type for a contact. Only available when summaryOnly parameter or paging is used, or when fetch by ContactId or ContactNumber.
+    attr_accessor :sales_default_line_amount_type
+    INCLUSIVE ||= "INCLUSIVE".freeze
+    EXCLUSIVE ||= "EXCLUSIVE".freeze
+    NONE ||= "NONE".freeze
+    
+    # The default purchases line amount type for a contact Only available when summaryOnly parameter or paging is used, or when fetch by ContactId or ContactNumber.
+    attr_accessor :purchases_default_line_amount_type
+    INCLUSIVE ||= "INCLUSIVE".freeze
+    EXCLUSIVE ||= "EXCLUSIVE".freeze
+    NONE ||= "NONE".freeze
+    
 
     attr_accessor :default_currency
-
+    
     # Store XeroNetworkKey for contacts.
     attr_accessor :xero_network_key
-
+    
     # The default sales account code for contacts
     attr_accessor :sales_default_account_code
-
+    
     # The default purchases account code for contacts
     attr_accessor :purchases_default_account_code
-
+    
     # The default sales tracking categories for contacts
     attr_accessor :sales_tracking_categories
-
+    
     # The default purchases tracking categories for contacts
     attr_accessor :purchases_tracking_categories
-
+    
     # The name of the Tracking Category assigned to the contact under SalesTrackingCategories and PurchasesTrackingCategories
     attr_accessor :tracking_category_name
-
+    
     # The name of the Tracking Option assigned to the contact under SalesTrackingCategories and PurchasesTrackingCategories
     attr_accessor :tracking_category_option
+    
 
     attr_accessor :payment_terms
-
+    
     # UTC timestamp of last update to contact
     attr_accessor :updated_date_utc
-
+    
     # Displays which contact groups a contact is included in
     attr_accessor :contact_groups
-
+    
     # Website address for contact (read only)
     attr_accessor :website
+    
 
     attr_accessor :branding_theme
+    
 
     attr_accessor :batch_payments
-
+    
     # The default discount rate for the contact (read only)
     attr_accessor :discount
+    
 
     attr_accessor :balances
-
+    
     # Displays array of attachments from the API
     attr_accessor :attachments
-
+    
     # A boolean to indicate if a contact has an attachment
     attr_accessor :has_attachments
-
+    
     # Displays validation errors returned from the API
     attr_accessor :validation_errors
-
+    
     # A boolean to indicate if a contact has an validation errors
     attr_accessor :has_validation_errors
-
+    
     # Status of object
     attr_accessor :status_attribute_string
-
+    
     class EnumAttributeValidator
       attr_reader :datatype
       attr_reader :allowable_values
@@ -153,14 +177,15 @@ module XeroRuby::Accounting
     def self.attribute_map
       {
         :'contact_id' => :'ContactID',
+        :'merged_to_contact_id' => :'MergedToContactID',
         :'contact_number' => :'ContactNumber',
         :'account_number' => :'AccountNumber',
         :'contact_status' => :'ContactStatus',
         :'name' => :'Name',
         :'first_name' => :'FirstName',
         :'last_name' => :'LastName',
+        :'company_number' => :'CompanyNumber',
         :'email_address' => :'EmailAddress',
-        :'skype_user_name' => :'SkypeUserName',
         :'contact_persons' => :'ContactPersons',
         :'bank_account_details' => :'BankAccountDetails',
         :'tax_number' => :'TaxNumber',
@@ -170,6 +195,8 @@ module XeroRuby::Accounting
         :'phones' => :'Phones',
         :'is_supplier' => :'IsSupplier',
         :'is_customer' => :'IsCustomer',
+        :'sales_default_line_amount_type' => :'SalesDefaultLineAmountType',
+        :'purchases_default_line_amount_type' => :'PurchasesDefaultLineAmountType',
         :'default_currency' => :'DefaultCurrency',
         :'xero_network_key' => :'XeroNetworkKey',
         :'sales_default_account_code' => :'SalesDefaultAccountCode',
@@ -198,14 +225,15 @@ module XeroRuby::Accounting
     def self.openapi_types
       {
         :'contact_id' => :'String',
+        :'merged_to_contact_id' => :'String',
         :'contact_number' => :'String',
         :'account_number' => :'String',
         :'contact_status' => :'String',
         :'name' => :'String',
         :'first_name' => :'String',
         :'last_name' => :'String',
+        :'company_number' => :'String',
         :'email_address' => :'String',
-        :'skype_user_name' => :'String',
         :'contact_persons' => :'Array<ContactPerson>',
         :'bank_account_details' => :'String',
         :'tax_number' => :'String',
@@ -215,6 +243,8 @@ module XeroRuby::Accounting
         :'phones' => :'Array<Phone>',
         :'is_supplier' => :'Boolean',
         :'is_customer' => :'Boolean',
+        :'sales_default_line_amount_type' => :'String',
+        :'purchases_default_line_amount_type' => :'String',
         :'default_currency' => :'CurrencyCode',
         :'xero_network_key' => :'String',
         :'sales_default_account_code' => :'String',
@@ -229,7 +259,7 @@ module XeroRuby::Accounting
         :'website' => :'String',
         :'branding_theme' => :'BrandingTheme',
         :'batch_payments' => :'BatchPaymentDetails',
-        :'discount' => :'Float',
+        :'discount' => :'BigDecimal',
         :'balances' => :'Balances',
         :'attachments' => :'Array<Attachment>',
         :'has_attachments' => :'Boolean',
@@ -258,6 +288,10 @@ module XeroRuby::Accounting
         self.contact_id = attributes[:'contact_id']
       end
 
+      if attributes.key?(:'merged_to_contact_id')
+        self.merged_to_contact_id = attributes[:'merged_to_contact_id']
+      end
+
       if attributes.key?(:'contact_number')
         self.contact_number = attributes[:'contact_number']
       end
@@ -282,12 +316,12 @@ module XeroRuby::Accounting
         self.last_name = attributes[:'last_name']
       end
 
-      if attributes.key?(:'email_address')
-        self.email_address = attributes[:'email_address']
+      if attributes.key?(:'company_number')
+        self.company_number = attributes[:'company_number']
       end
 
-      if attributes.key?(:'skype_user_name')
-        self.skype_user_name = attributes[:'skype_user_name']
+      if attributes.key?(:'email_address')
+        self.email_address = attributes[:'email_address']
       end
 
       if attributes.key?(:'contact_persons')
@@ -332,6 +366,14 @@ module XeroRuby::Accounting
         self.is_customer = attributes[:'is_customer']
       end
 
+      if attributes.key?(:'sales_default_line_amount_type')
+        self.sales_default_line_amount_type = attributes[:'sales_default_line_amount_type']
+      end
+
+      if attributes.key?(:'purchases_default_line_amount_type')
+        self.purchases_default_line_amount_type = attributes[:'purchases_default_line_amount_type']
+      end
+
       if attributes.key?(:'default_currency')
         self.default_currency = attributes[:'default_currency']
       end
@@ -422,6 +464,8 @@ module XeroRuby::Accounting
 
       if attributes.key?(:'has_validation_errors')
         self.has_validation_errors = attributes[:'has_validation_errors']
+      else
+        self.has_validation_errors = false
       end
 
       if attributes.key?(:'status_attribute_string')
@@ -453,6 +497,10 @@ module XeroRuby::Accounting
         invalid_properties.push('invalid value for "last_name", the character length must be smaller than or equal to 255.')
       end
 
+      if !@company_number.nil? && @company_number.to_s.length > 50
+        invalid_properties.push('invalid value for "company_number", the character length must be smaller than or equal to 50.')
+      end
+
       if !@email_address.nil? && @email_address.to_s.length > 255
         invalid_properties.push('invalid value for "email_address", the character length must be smaller than or equal to 255.')
       end
@@ -474,8 +522,13 @@ module XeroRuby::Accounting
       return false if !@name.nil? && @name.to_s.length > 255
       return false if !@first_name.nil? && @first_name.to_s.length > 255
       return false if !@last_name.nil? && @last_name.to_s.length > 255
+      return false if !@company_number.nil? && @company_number.to_s.length > 50
       return false if !@email_address.nil? && @email_address.to_s.length > 255
       return false if !@tax_number.nil? && @tax_number.to_s.length > 50
+      sales_default_line_amount_type_validator = EnumAttributeValidator.new('String', ["INCLUSIVE", "EXCLUSIVE", "NONE"])
+      return false unless sales_default_line_amount_type_validator.valid?(@sales_default_line_amount_type)
+      purchases_default_line_amount_type_validator = EnumAttributeValidator.new('String', ["INCLUSIVE", "EXCLUSIVE", "NONE"])
+      return false unless purchases_default_line_amount_type_validator.valid?(@purchases_default_line_amount_type)
       true
     end
 
@@ -539,6 +592,16 @@ module XeroRuby::Accounting
       @last_name = last_name
     end
 
+    # Custom attribute writer method with validation
+    # @param [Object] company_number Value to be assigned
+    def company_number=(company_number)
+      if !company_number.nil? && company_number.to_s.length > 50
+        fail ArgumentError, 'invalid value for "company_number", the character length must be smaller than or equal to 50.'
+      end
+
+      @company_number = company_number
+    end
+
     # Custom attribute writer method with validation
     # @param [Object] email_address Value to be assigned
     def email_address=(email_address)
@@ -559,20 +622,41 @@ module XeroRuby::Accounting
       @tax_number = tax_number
     end
 
+    # Custom attribute writer method checking allowed values (enum).
+    # @param [Object] sales_default_line_amount_type Object to be assigned
+    def sales_default_line_amount_type=(sales_default_line_amount_type)
+      validator = EnumAttributeValidator.new('String', ["INCLUSIVE", "EXCLUSIVE", "NONE"])
+      unless validator.valid?(sales_default_line_amount_type)
+        fail ArgumentError, "invalid value for \"sales_default_line_amount_type\", must be one of #{validator.allowable_values}."
+      end
+      @sales_default_line_amount_type = sales_default_line_amount_type
+    end
+
+    # Custom attribute writer method checking allowed values (enum).
+    # @param [Object] purchases_default_line_amount_type Object to be assigned
+    def purchases_default_line_amount_type=(purchases_default_line_amount_type)
+      validator = EnumAttributeValidator.new('String', ["INCLUSIVE", "EXCLUSIVE", "NONE"])
+      unless validator.valid?(purchases_default_line_amount_type)
+        fail ArgumentError, "invalid value for \"purchases_default_line_amount_type\", must be one of #{validator.allowable_values}."
+      end
+      @purchases_default_line_amount_type = purchases_default_line_amount_type
+    end
+
     # Checks equality by comparing each attribute.
     # @param [Object] Object to be compared
     def ==(o)
       return true if self.equal?(o)
       self.class == o.class &&
           contact_id == o.contact_id &&
+          merged_to_contact_id == o.merged_to_contact_id &&
           contact_number == o.contact_number &&
           account_number == o.account_number &&
           contact_status == o.contact_status &&
           name == o.name &&
           first_name == o.first_name &&
           last_name == o.last_name &&
+          company_number == o.company_number &&
           email_address == o.email_address &&
-          skype_user_name == o.skype_user_name &&
           contact_persons == o.contact_persons &&
           bank_account_details == o.bank_account_details &&
           tax_number == o.tax_number &&
@@ -582,6 +666,8 @@ module XeroRuby::Accounting
           phones == o.phones &&
           is_supplier == o.is_supplier &&
           is_customer == o.is_customer &&
+          sales_default_line_amount_type == o.sales_default_line_amount_type &&
+          purchases_default_line_amount_type == o.purchases_default_line_amount_type &&
           default_currency == o.default_currency &&
           xero_network_key == o.xero_network_key &&
           sales_default_account_code == o.sales_default_account_code &&
@@ -614,7 +700,7 @@ module XeroRuby::Accounting
     # Calculates hash code according to all attributes.
     # @return [Integer] Hash code
     def hash
-      [contact_id, contact_number, account_number, contact_status, name, first_name, last_name, email_address, skype_user_name, contact_persons, bank_account_details, tax_number, accounts_receivable_tax_type, accounts_payable_tax_type, addresses, phones, is_supplier, is_customer, default_currency, xero_network_key, sales_default_account_code, purchases_default_account_code, sales_tracking_categories, purchases_tracking_categories, tracking_category_name, tracking_category_option, payment_terms, updated_date_utc, contact_groups, website, branding_theme, batch_payments, discount, balances, attachments, has_attachments, validation_errors, has_validation_errors, status_attribute_string].hash
+      [contact_id, merged_to_contact_id, contact_number, account_number, contact_status, name, first_name, last_name, company_number, email_address, contact_persons, bank_account_details, tax_number, accounts_receivable_tax_type, accounts_payable_tax_type, addresses, phones, is_supplier, is_customer, sales_default_line_amount_type, purchases_default_line_amount_type, default_currency, xero_network_key, sales_default_account_code, purchases_default_account_code, sales_tracking_categories, purchases_tracking_categories, tracking_category_name, tracking_category_option, payment_terms, updated_date_utc, contact_groups, website, branding_theme, batch_payments, discount, balances, attachments, has_attachments, validation_errors, has_validation_errors, status_attribute_string].hash
     end
 
     # Builds the object from hash
@@ -660,6 +746,8 @@ module XeroRuby::Accounting
         value.to_i
       when :Float
         value.to_f
+      when :BigDecimal
+        BigDecimal(value.to_s)
       when :Boolean
         if value.to_s =~ /\A(true|t|yes|y|1)\z/i
           true
@@ -699,38 +787,53 @@ module XeroRuby::Accounting
 
     # Returns the object in the form of hash
     # @return [Hash] Returns the object in the form of hash
-    def to_hash
+    def to_hash(downcase: false)
       hash = {}
       self.class.attribute_map.each_pair do |attr, param|
         value = self.send(attr)
         next if value.nil?
-        hash[param] = _to_hash(value)
+        key = downcase ? attr : param
+        hash[key] = _to_hash(value, downcase: downcase)
       end
       hash
     end
 
+    # Returns the object in the form of hash with snake_case
+    def to_attributes
+      to_hash(downcase: true)
+    end
+
     # Outputs non-array value in the form of hash
     # For object, use to_hash. Otherwise, just return the value
     # @param [Object] value Any valid value
     # @return [Hash] Returns the value in the form of hash
-    def _to_hash(value)
+    def _to_hash(value, downcase: false)
       if value.is_a?(Array)
-        value.compact.map { |v| _to_hash(v) }
+        value.map do |v|
+          v.to_hash(downcase: downcase)
+        end
       elsif value.is_a?(Hash)
         {}.tap do |hash|
-          value.each { |k, v| hash[k] = _to_hash(v) }
+          value.map { |k, v| hash[k] = _to_hash(v, downcase: downcase) }
         end
       elsif value.respond_to? :to_hash
-        value.to_hash
+        value.to_hash(downcase: downcase)
       else
         value
       end
     end
 
-    # customized data_parser
     def parse_date(datestring)
-      seconds_since_epoch = datestring.scan(/[0-9]+/)[0].to_i / 1000.0
-      return Time.at(seconds_since_epoch).to_s
+      if datestring.include?('Date')
+        date_pattern = /\/Date\((-?\d+)(\+\d+)?\)\//
+        original, date, timezone = *date_pattern.match(datestring)
+        date = (date.to_i / 1000)
+        Time.at(date).utc.strftime('%Y-%m-%dT%H:%M:%S%z').to_s
+      elsif /(\d\d\d\d)-(\d\d)/.match(datestring) # handles dates w/out Days: YYYY-MM*-DD
+        Time.parse(datestring + '-01').strftime('%Y-%m-%dT%H:%M:%S').to_s
+      else # handle date 'types' for small subset of payroll API's
+        Time.parse(datestring).strftime('%Y-%m-%dT%H:%M:%S').to_s
+      end
     end
   end
 end

data/lib/xero-ruby/models/accounting/contact_group.rb

@@ -1,12 +1,11 @@
 =begin
-#Accounting API
+#Xero Accounting API
 
 #No description provided (generated by Openapi Generator https://github.com/openapitools/openapi-generator)
 
-The version of the OpenAPI document: 2.1.3
 Contact: api@xero.com
 Generated by: https://openapi-generator.tech
-OpenAPI Generator version: 4.3.0
+OpenAPI Generator version: 4.3.1
 
 =end
 
@@ -14,19 +13,23 @@ require 'time'
 require 'date'
 
 module XeroRuby::Accounting
+  require 'bigdecimal'
+
   class ContactGroup
     # The Name of the contact group. Required when creating a new contact  group
     attr_accessor :name
-
+    
     # The Status of a contact group. To delete a contact group update the status to DELETED. Only contact groups with a status of ACTIVE are returned on GETs.
     attr_accessor :status
-
+    ACTIVE ||= "ACTIVE".freeze
+    DELETED ||= "DELETED".freeze
+    
     # The Xero identifier for an contact group – specified as a string following the endpoint name. e.g. /297c2dc5-cc47-4afd-8ec8-74990b8761e9
     attr_accessor :contact_group_id
-
+    
     # The ContactID and Name of Contacts in a contact group. Returned on GETs when the ContactGroupID is supplied in the URL.
     attr_accessor :contacts
-
+    
     class EnumAttributeValidator
       attr_reader :datatype
       attr_reader :allowable_values
@@ -194,6 +197,8 @@ module XeroRuby::Accounting
         value.to_i
       when :Float
         value.to_f
+      when :BigDecimal
+        BigDecimal(value.to_s)
       when :Boolean
         if value.to_s =~ /\A(true|t|yes|y|1)\z/i
           true
@@ -233,38 +238,53 @@ module XeroRuby::Accounting
 
     # Returns the object in the form of hash
     # @return [Hash] Returns the object in the form of hash
-    def to_hash
+    def to_hash(downcase: false)
       hash = {}
       self.class.attribute_map.each_pair do |attr, param|
         value = self.send(attr)
         next if value.nil?
-        hash[param] = _to_hash(value)
+        key = downcase ? attr : param
+        hash[key] = _to_hash(value, downcase: downcase)
       end
       hash
     end
 
+    # Returns the object in the form of hash with snake_case
+    def to_attributes
+      to_hash(downcase: true)
+    end
+
     # Outputs non-array value in the form of hash
     # For object, use to_hash. Otherwise, just return the value
     # @param [Object] value Any valid value
     # @return [Hash] Returns the value in the form of hash
-    def _to_hash(value)
+    def _to_hash(value, downcase: false)
       if value.is_a?(Array)
-        value.compact.map { |v| _to_hash(v) }
+        value.map do |v|
+          v.to_hash(downcase: downcase)
+        end
       elsif value.is_a?(Hash)
         {}.tap do |hash|
-          value.each { |k, v| hash[k] = _to_hash(v) }
+          value.map { |k, v| hash[k] = _to_hash(v, downcase: downcase) }
         end
       elsif value.respond_to? :to_hash
-        value.to_hash
+        value.to_hash(downcase: downcase)
       else
         value
       end
     end
 
-    # customized data_parser
     def parse_date(datestring)
-      seconds_since_epoch = datestring.scan(/[0-9]+/)[0].to_i / 1000.0
-      return Time.at(seconds_since_epoch).to_s
+      if datestring.include?('Date')
+        date_pattern = /\/Date\((-?\d+)(\+\d+)?\)\//
+        original, date, timezone = *date_pattern.match(datestring)
+        date = (date.to_i / 1000)
+        Time.at(date).utc.strftime('%Y-%m-%dT%H:%M:%S%z').to_s
+      elsif /(\d\d\d\d)-(\d\d)/.match(datestring) # handles dates w/out Days: YYYY-MM*-DD
+        Time.parse(datestring + '-01').strftime('%Y-%m-%dT%H:%M:%S').to_s
+      else # handle date 'types' for small subset of payroll API's
+        Time.parse(datestring).strftime('%Y-%m-%dT%H:%M:%S').to_s
+      end
     end
   end
 end