business-central 1.0.2 → 1.0.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 918c17b06f28ef71d9866952c18674f7251b7456444660a2d6db20dccb3ed16c
-  data.tar.gz: 89399ed2fb0f96b3d3e680accdc3193a44d640a44e1e831650a0f810604dd0df
+  metadata.gz: bfee02464cc6b4a28c6208ced736a5d8453f917cbe8757f7e28cd6ad900721d6
+  data.tar.gz: ca2a683c9f3440d4fa953507051021145b1690bd42152ba488eae70c451ce2ae
 SHA512:
-  metadata.gz: 8d555669929150b37fdc67ce0394bdf251012cc009e851cb35f8a8bbb82c8633b60f330eb5d81d891a087e4dda8fe2bb59790a76dd65b61d4fe153b50b6b1316
-  data.tar.gz: bdecc5f196538bebb0e5c5f97f20574590031f0830c0e07fc5cb61d1279ef6ba3e6c2ecb2337278e167c7ff9e25ddb2246c125e49fc77bb0a2e70cb090c8e65b
+  metadata.gz: 454c708a9323072524312b21877aca84918c2bb2c611956849291446c9117a007301112333d7c3bf25b3e5ac1707a81a2bdde2d7b3cc50f561ec0d28df5a40d0
+  data.tar.gz: 78cbb22465b21ca9f876c621986e55a9843df5b9505a6552425ae56667258aaddff9ec76e3a00f5b7f820572e3a3bf887c2d49516d8e2b203f0ef2d02bf52aaf

data/lib/business_central.rb

@@ -20,6 +20,12 @@ require 'business_central/object/company'
 require 'business_central/object/company_information'
 require 'business_central/object/country_region'
 require 'business_central/object/currency'
+require 'business_central/object/customer'
+require 'business_central/object/customer_financial_detail'
+require 'business_central/object/customer_payment'
+require 'business_central/object/customer_payment_journal'
+require 'business_central/object/customer_sale'
+require 'business_central/object/default_dimension'
 require 'business_central/object/vendor'
 require 'business_central/object/item'
 require 'business_central/object/purchase_invoice'

data/lib/business_central/client.rb

@@ -4,13 +4,17 @@ module BusinessCentral
 
     DEFAULT_URL = 'https://api.businesscentral.dynamics.com/v1.0/api/beta'.freeze
 
+    DEFAULT_LOGIN_URL = 'https://login.microsoftonline.com/common'.freeze
+
     attr_reader :tenant_id,
                 :username,
                 :password,
                 :application_id,
                 :secret_key,
                 :url,
-                :oauth2_client
+                :oauth2_login_url,
+                :oauth2_client,
+                :default_company_id
 
     alias_method :access_token, :oauth2_client
 
@@ -23,6 +27,12 @@ module BusinessCentral
     object :company_information
     object :country_region
     object :currency
+    object :customer
+    object :customer_financial_detail
+    object :customer_payment
+    object :customer_payment_journal
+    object :customer_sale
+    object :default_dimension
     object :vendor
     object :purchase_invoice
     object :purchase_invoice_line
@@ -36,13 +46,15 @@ module BusinessCentral
       @url = opts.delete(:url) || DEFAULT_URL
       @application_id = opts.delete(:application_id)
       @secret_key = opts.delete(:secret_key)
+      @oauth2_login_url = opts.delete(:oauth2_login_url) || DEFAULT_LOGIN_URL
+      @default_company_id = opts.delete(:default_company_id)
     end
 
     def authorize(params = {}, oauth_authorize_callback: '')
       params[:redirect_uri] = oauth_authorize_callback
       begin
         oauth2_client.auth_code.authorize_url(params)
-      rescue Oauth2::Error => error
+      rescue OAuth2::Error => error
         handle_error(error)
       end
     end
@@ -77,7 +89,7 @@ module BusinessCentral
           @application_id,
           @secret_key,
           {
-            site: "https://login.windows.net/#{@tenant_id}",
+            site: @oauth2_login_url,
             authorize_url: 'oauth2/authorize?resource=https://api.businesscentral.dynamics.com',
             token_url: 'oauth2/token?resource=https://api.businesscentral.dynamics.com'
           }
@@ -88,7 +100,7 @@ module BusinessCentral
     end
 
     def handle_error(error)
-      if error.code.present?
+      if !error.code.nil?
         case error.code
           when 'invalid_client'
             raise InvalidClientException.new

data/lib/business_central/exceptions.rb

@@ -4,7 +4,7 @@ module BusinessCentral
 
   class InvalidClientException < BusinessCentralError
     def message
-      'Invalid application setup'
+      'Invalid client setup'
     end
   end
 
@@ -52,4 +52,14 @@ module BusinessCentral
       "#{method} method is currently not support. Allowed methods are: #{allowed_methods.join(', ')}"
     end
   end
+
+  class InvalidArgumentException < BusinessCentralError
+    def initialize(message)
+      @message = message
+    end
+
+    def message
+      "Invalid argument entered - #{@message}"
+    end
+  end
 end

data/lib/business_central/object/account.rb

@@ -6,16 +6,6 @@ module BusinessCentral
       OBJECT_METHODS = [
         :get
       ].freeze
-
-      def initialize(client, company_id:)
-        super(client, company_id: company_id)
-        @parent_path = [
-          {
-            path: 'companies',
-            id: company_id
-          }
-        ]
-      end
     end
   end
 end

data/lib/business_central/object/aged_account_payable.rb

@@ -6,16 +6,6 @@ module BusinessCentral
       OBJECT_METHODS = [
         :get
       ].freeze
-
-      def initialize(client, company_id:)
-        super(client, company_id: company_id)
-        @parent_path = [
-          {
-            path: 'companies',
-            id: company_id
-          }
-        ]
-      end
     end
   end
 end

data/lib/business_central/object/aged_account_receivable.rb

@@ -6,16 +6,6 @@ module BusinessCentral
       OBJECT_METHODS = [
         :get
       ].freeze
-
-      def initialize(client, company_id:)
-        super(client, company_id: company_id)
-        @parent_path = [
-          {
-            path: 'companies',
-            id: company_id
-          }
-        ]
-      end
     end
   end
 end

data/lib/business_central/object/balance_sheet.rb

@@ -6,16 +6,6 @@ module BusinessCentral
       OBJECT_METHODS = [
         :get
       ].freeze
-
-      def initialize(client, company_id:)
-        super(client, company_id: company_id)
-        @parent_path = [
-          {
-            path: 'companies',
-            id: company_id
-          }
-        ]
-      end
     end
   end
 end

data/lib/business_central/object/base.rb

@@ -2,17 +2,34 @@ module BusinessCentral
   module Object
     class Base
       attr_reader :client,
-                  :company_id,
                   :parent_path,
-                  :path,
-                  :errors
+                  :path
+
+      attr_writer :id, :company_id
 
       def initialize(client, args = {})
         @client = client
-        @company_id = args[:company_id] if !args.nil?
-        @parent_path = []
-        @path = ''
-        @errors = []
+        @id = id(args)
+        @company_id = company_id(args)
+        @parent_path = @company_id.nil? ? [] : [
+          {
+            path: 'companies',
+            id: @company_id
+          }
+        ]
+      end
+
+      def id(argument)
+        return @id if !@id.nil?
+        return argument.fetch(:id, '') if !argument.nil?
+        return nil
+      end
+
+      def company_id(argument)
+        return @client.default_company_id if !@client.default_company_id.nil?
+        return @company_id if !@company_id.nil?
+        return argument.fetch(:company_id, '') if !argument.nil?
+        return nil
       end
 
       def find_all
@@ -51,9 +68,9 @@ module BusinessCentral
 
       def update(id, params = {})
         if method_supported?(:patch)
-          object = find_by_id(id)
-          if Validation.new(object_validation, params).valid?
-            Request.patch(@client, build_url(parent_path: @parent_path, child_path: object_name, child_id: id), object[:etag], params)
+          object = find_by_id(id).merge(params)
+          if Validation.new(object_validation, object).valid?
+            Request.patch(@client, build_url(parent_path: @parent_path, child_path: object_name, child_id: id), object[:etag], object)
           end
         else
           raise BusinessCentral::NoSupportedMethod.new(:patch, object_methods)
@@ -95,9 +112,9 @@ module BusinessCentral
       def url_builder(parent_path = [], child_path = '', child_id = '', filter = '')
         url = @client.url
         url += parent_path.map { |parent| "/#{parent[:path]}(#{parent[:id]})" }.join('') if !parent_path.empty?
-        url += "/#{child_path}" if !child_path.blank?
-        url += "(#{child_id})" if !child_id.blank?
-        url += "?$filter=#{CGI::escape(filter)}" if !filter.blank?
+        url += "/#{child_path}" if !child_path.to_s.blank?
+        url += "(#{child_id})" if !child_id.to_s.blank?
+        url += "?$filter=#{CGI::escape(filter)}" if !filter.to_s.blank?
         return url
       end
     end

data/lib/business_central/object/cash_flow_statement.rb

@@ -6,16 +6,6 @@ module BusinessCentral
       OBJECT_METHODS = [
         :get
       ].freeze
-
-      def initialize(client, company_id:)
-        super(client, company_id: company_id)
-        @parent_path = [
-          {
-            path: 'companies',
-            id: company_id
-          }
-        ]
-      end
     end
   end
 end

data/lib/business_central/object/company.rb

@@ -6,6 +6,11 @@ module BusinessCentral
       OBJECT_METHODS = [
         :get
       ].freeze
+
+      def initialize(client, args)
+        super(client)
+        @parent_path = []
+      end
     end
   end
 end

data/lib/business_central/object/company_information.rb

@@ -7,16 +7,6 @@ module BusinessCentral
         :get,
         :patch
       ].freeze
-
-      def initialize(client, company_id:)
-        super(client, company_id: company_id)
-        @parent_path = [
-          {
-            path: 'companies',
-            id: company_id
-          }
-        ]
-      end
     end
   end
 end

data/lib/business_central/object/country_region.rb

@@ -19,16 +19,6 @@ module BusinessCentral
         :patch,
         :delete
       ].freeze
-
-      def initialize(client, company_id:)
-        super(client, company_id: company_id)
-        @parent_path = [
-          {
-            path: 'companies',
-            id: company_id
-          }
-        ]
-      end
     end
   end
 end

data/lib/business_central/object/currency.rb

@@ -22,16 +22,6 @@ module BusinessCentral
         :patch,
         :delete
       ].freeze
-
-      def initialize(client, company_id:)
-        super(client, company_id: company_id)
-        @parent_path = [
-          {
-            path: 'companies',
-            id: company_id
-          }
-        ]
-      end
     end
   end
 end

data/lib/business_central/object/customer.rb

@@ -0,0 +1,27 @@
+module BusinessCentral
+  module Object
+    class Customer < Base
+      OBJECT = 'customers'.freeze
+
+      OBJECT_VALIDATION = {
+        display_name: {
+          required: true,
+          maximum_length: 100
+        },
+        type: {
+          inclusion_of: [
+            'Company',
+            'Person'
+          ]
+        }
+      }.freeze
+
+      OBJECT_METHODS = [
+        :get,
+        :post,
+        :patch,
+        :delete
+      ].freeze
+    end
+  end
+end

data/lib/business_central/object/customer_financial_detail.rb

@@ -0,0 +1,11 @@
+module BusinessCentral
+  module Object
+    class CustomerFinancialDetail < Base
+      OBJECT = 'customerFinancialDetails'.freeze
+
+      OBJECT_METHODS = [
+        :get
+      ].freeze
+    end
+  end
+end

data/lib/business_central/object/customer_payment.rb

@@ -0,0 +1,41 @@
+module BusinessCentral
+  module Object
+    class CustomerPayment < Base
+      OBJECT = 'customerPayments'.freeze
+
+      OBJECT_VALIDATION = {
+        customer_number: {
+          maximum_length: 20
+        },
+        contact_id: {
+          maximum_length: 250
+        },
+        posting_date: {
+          date: true
+        },
+        document_number: {
+          maximum_length: 20
+        },
+        external_document_number: {
+          maximum_length: 20
+        },
+        applies_to_invoice_number: {
+          maximum_length: 20
+        },
+        description: {
+          maximum_length: 50
+        },
+        comment: {
+          maximum_length: 250
+        }
+      }.freeze
+
+      OBJECT_METHODS = [
+        :get,
+        :post,
+        :patch,
+        :delete
+      ].freeze
+    end
+  end
+end

data/lib/business_central/object/customer_payment_journal.rb

@@ -0,0 +1,23 @@
+module BusinessCentral
+  module Object
+    class CustomerPaymentJournal < Base
+      OBJECT = 'customerPaymentJournals'.freeze
+
+      OBJECT_VALIDATION = {
+        code: {
+          maximum_length: 10
+        },
+        display_name: {
+          maximum_length: 50
+        }
+      }.freeze
+
+      OBJECT_METHODS = [
+        :get,
+        :post,
+        :patch,
+        :delete
+      ].freeze
+    end
+  end
+end