business-central 1.0.3 → 1.0.7

data/lib/business_central/object/item.rb

@@ -1,7 +1,11 @@
+# frozen_string_literal: true
+
 module BusinessCentral
   module Object
     class Item < Base
-      OBJECT = 'items'.freeze
+      extend BusinessCentral::Object::ObjectHelper
+
+      OBJECT = 'items'
 
       OBJECT_VALIDATION = {
         number: {
@@ -12,10 +16,10 @@ module BusinessCentral
         },
         type: {
           required: true,
-          inclusive_of: [
-            'Inventory',
-            'Service',
-            'Non-Inventory'
+          inclusive_of: %w[
+            Inventory
+            Service
+            Non-Inventory
           ]
         },
         item_category_code: {
@@ -29,12 +33,15 @@ module BusinessCentral
         }
       }.freeze
 
-      OBJECT_METHODS = [
-        :get,
-        :post,
-        :patch,
-        :delete
+      OBJECT_METHODS = %i[
+        get
+        post
+        patch
+        delete
       ].freeze
+
+      navigation :default_dimension
+      navigation :picture
     end
   end
 end

data/lib/business_central/object/item_category.rb

@@ -0,0 +1,16 @@
+# frozen_string_literal: true
+
+module BusinessCentral
+  module Object
+    class ItemCategory < Base
+      OBJECT = 'itemCategories'
+
+      OBJECT_METHODS = %i[
+        get
+        post
+        patch
+        delete
+      ].freeze
+    end
+  end
+end

data/lib/business_central/object/journal.rb

@@ -0,0 +1,29 @@
+# frozen_string_literal: true
+
+module BusinessCentral
+  module Object
+    class Journal < Base
+      extend BusinessCentral::Object::ObjectHelper
+
+      OBJECT = 'journals'
+
+      OBJECT_VALIDATION = {
+        code: {
+          maximum_length: 10
+        },
+        display_name: {
+          maximum_length: 50
+        }
+      }.freeze
+
+      OBJECT_METHODS = %i[
+        get
+        post
+        patch
+        delete
+      ].freeze
+
+      navigation :journal_line
+    end
+  end
+end

data/lib/business_central/object/journal_line.rb

@@ -0,0 +1,48 @@
+# frozen_string_literal: true
+
+module BusinessCentral
+  module Object
+    class JournalLine < Base
+      OBJECT = 'journalLines'
+
+      OBJECT_VALIDATION = {
+        account_number: {
+          maximum_length: 20
+        },
+        document_number: {
+          maximum_length: 20
+        },
+        external_document_number: {
+          maximum_length: 20
+        },
+        description: {
+          maximum_length: 50
+        },
+        comment: {
+          maximum_length: 250
+        }
+      }.freeze
+
+      OBJECT_METHODS = %i[
+        get
+        post
+        patch
+        delete
+      ].freeze
+
+      OBJECT_PARENTS = %w[
+        journals
+      ].freeze
+
+      def initialize(client, parent: 'journals', parent_id:, **args)
+        return if !valid_parent?(parent)
+
+        super(client, args)
+        @parent_path << {
+          path: parent,
+          id: parent_id
+        }
+      end
+    end
+  end
+end

data/lib/business_central/object/{helper.rb → object_helper.rb}

@@ -1,14 +1,20 @@
+# frozen_string_literal: true
+
 module BusinessCentral
   module Object
-    module Helper
-      def object(object_name, *params)
-        define_method(object_name) do |argument=nil|
+    module ObjectHelper
+      include ArgumentHelper
+
+      def object(object_name, *_params)
+        define_method(object_name) do |argument = nil|
           object = "@#{object_name}_cache".to_sym
           if argument.nil?
             if !instance_variable_defined?(object)
               instance_variable_set(
                 object,
-                BusinessCentral::Object.const_get("#{object_name.to_s.to_camel_case(true)}".to_sym).new(self, argument)
+                BusinessCentral::Object.const_get(
+                  object_name.to_s.to_camel_case(true).to_s.to_sym
+                ).new(self, argument)
               )
             else
               instance_variable_get(object)
@@ -16,19 +22,21 @@ module BusinessCentral
           else
             instance_variable_set(
               object,
-              BusinessCentral::Object.const_get("#{object_name.to_s.to_camel_case(true)}".to_sym).new(self, argument)
+              BusinessCentral::Object.const_get(
+                object_name.to_s.to_camel_case(true).to_s.to_sym
+              ).new(self, **argument)
             )
           end
         end
       end
 
-      def navigation(object_name, *params)
-        define_method(object_name) do |argument=nil|
+      def navigation(object_name, *_params)
+        define_method(object_name) do |argument = nil|
           object = "@#{object_name}_cache".to_sym
           instance_variable_set(
             object,
-            BusinessCentral::Object.const_get("#{object_name.to_s.to_camel_case(true)}".to_sym).new(
-              self.client,
+            BusinessCentral::Object.const_get(object_name.to_s.to_camel_case(true).to_s.to_sym).new(
+              client,
               company_id: company_id(argument),
               parent: self.class.const_get(:OBJECT),
               parent_id: id(argument)
@@ -38,4 +46,4 @@ module BusinessCentral
       end
     end
   end
-end
+end

data/lib/business_central/object/payment_method.rb

@@ -0,0 +1,16 @@
+# frozen_string_literal: true
+
+module BusinessCentral
+  module Object
+    class PaymentMethod < Base
+      OBJECT = 'paymentMethods'
+
+      OBJECT_METHODS = %i[
+        get
+        post
+        patch
+        delete
+      ].freeze
+    end
+  end
+end

data/lib/business_central/object/payment_term.rb

@@ -0,0 +1,16 @@
+# frozen_string_literal: true
+
+module BusinessCentral
+  module Object
+    class PaymentTerm < Base
+      OBJECT = 'paymentTerms'
+
+      OBJECT_METHODS = %i[
+        get
+        post
+        patch
+        delete
+      ].freeze
+    end
+  end
+end

data/lib/business_central/object/picture.rb

@@ -0,0 +1,53 @@
+# frozen_string_literal: true
+
+module BusinessCentral
+  module Object
+    class Picture < Base
+      OBJECT = 'picture'
+
+      OBJECT_METHODS = %i[
+        get
+        post
+        patch
+        delete
+      ].freeze
+
+      OBJECT_PARENTS = %w[
+        items
+        customers
+        vendors
+        employees
+      ].freeze
+
+      def initialize(client, parent:, parent_id:, **args)
+        return if !valid_parent?(parent)
+
+        super(client, args)
+        @parent_path << {
+          path: parent,
+          id: parent_id
+        }
+        @parent_id = parent_id
+      end
+
+      def create(data)
+        url = "#{build_url(parent_path: @parent_path, child_path: object_name)}(#{@parent_id})/content"
+        Request.call(:patch, @client, url, etag: '', params: {}) do |request|
+          request['Content-Type'] = 'application/octet-stream'
+          request['If-Match'] = '*'
+          request.body = data
+        end
+      end
+
+      def update(data)
+        url = "#{build_url(parent_path: @parent_path, child_path: object_name)}(#{@parent_id})"
+        object = Request.get(@client, url)
+        url = "#{build_url(parent_path: @parent_path, child_path: object_name)}(#{@parent_id})/content"
+        Request.call(:patch, @client, url, etag: object[:etag], params: {}) do |request|
+          request['Content-Type'] = 'application/octet-stream'
+          request.body = data
+        end
+      end
+    end
+  end
+end

data/lib/business_central/object/purchase_invoice.rb

@@ -1,7 +1,9 @@
+# frozen_string_literal: true
+
 module BusinessCentral
   module Object
     class PurchaseInvoice < Base
-      OBJECT = 'purchaseInvoices'.freeze
+      OBJECT = 'purchaseInvoices'
 
       OBJECT_VALIDATION = {
         number: {
@@ -56,11 +58,11 @@ module BusinessCentral
         }
       }.freeze
 
-      OBJECT_METHODS = [
-        :get,
-        :post,
-        :patch,
-        :delete
+      OBJECT_METHODS = %i[
+        get
+        post
+        patch
+        delete
       ].freeze
     end
   end

data/lib/business_central/object/purchase_invoice_line.rb

@@ -1,7 +1,9 @@
+# frozen_string_literal: true
+
 module BusinessCentral
   module Object
     class PurchaseInvoiceLine < Base
-      OBJECT = 'purchaseInvoiceLines'.freeze
+      OBJECT = 'purchaseInvoiceLines'
 
       OBJECT_VALIDATION = {
         line_type: {
@@ -16,15 +18,15 @@ module BusinessCentral
         }
       }.freeze
 
-      OBJECT_METHODS = [
-        :get,
-        :post,
-        :patch,
-        :delete
+      OBJECT_METHODS = %i[
+        get
+        post
+        patch
+        delete
       ].freeze
 
-      def initialize(client, company_id:, purchase_invoice_id:)
-        super(client, company_id: company_id)
+      def initialize(client, purchase_invoice_id:, **args)
+        super(client, args)
         @parent_path << {
           path: 'purchaseInvoices',
           id: purchase_invoice_id

data/lib/business_central/object/purchase_order.rb

@@ -0,0 +1,16 @@
+# frozen_string_literal: true
+
+module BusinessCentral
+  module Object
+    class PurchaseOrder < Base
+      OBJECT = 'purchaseOrders'
+
+      OBJECT_METHODS = %i[
+        get
+        post
+        patch
+        delete
+      ].freeze
+    end
+  end
+end

data/lib/business_central/object/request.rb

@@ -1,75 +1,86 @@
+# frozen_string_literal: true
+
 module BusinessCentral
   module Object
     class Request
+      class << self
+        def get(client, url)
+          request(:get, client, url)
+        end
 
-      def self.get(client, url)
-        request(:get, client, url)
-      end
-
-      def self.post(client, url, params)
-        request(:post, client, url, params: params)
-      end
-
-      def self.patch(client, url, etag, params)
-        request(:patch, client, url, etag: etag, params: params)
-      end
+        def post(client, url, params)
+          request(:post, client, url, params: params)
+        end
 
-      def self.delete(client, url, etag)
-        request(:delete, client, url, etag: etag)
-      end
+        def patch(client, url, etag, params)
+          request(:patch, client, url, etag: etag, params: params)
+        end
 
-      private
+        def delete(client, url, etag)
+          request(:delete, client, url, etag: etag)
+        end
 
-      def self.request(method, client, url, etag: '', params: {})
-        send do
-          uri = URI(url)
-          https = Net::HTTP.new(uri.host, uri.port);
-          https.use_ssl = true
-          request = Object.const_get("Net::HTTP::#{method.to_s.capitalize}").new(uri)
-          request['Content-Type'] = 'application/json'
-          request['Accept'] = 'application/json'
-          request['If-Match'] = etag if !etag.blank?
-          request.body = convert(params) if method == :post || method == :patch
-          if client.access_token
-            request['Authorization'] = "Bearer #{client.access_token.token}"
-          else
-            request.basic_auth(client.username, client.password)
+        def convert(request = {})
+          result = {}
+          request.each do |key, value|
+            result[key.to_s.to_camel_case] = value if key.is_a? Symbol
+            result[key.to_s] = value if key.is_a? String
           end
-          https.request(request)
+
+          result.to_json
         end
-      end
 
-      def self.convert(request = {})
-        result = {}
-        request.each do |key, value|
-          result[key.to_s.to_camel_case] = value if key.is_a? Symbol
+        def request(method, client, url, etag: '', params: {})
+          send do
+            uri = URI(url)
+            https = Net::HTTP.new(uri.host, uri.port)
+            https.use_ssl = true
+            https.set_debug_output($stdout) if client.debug
+            request = Object.const_get("Net::HTTP::#{method.to_s.capitalize}").new(uri)
+            request['If-Match'] = etag if !etag.blank?
+            request['Accept'] = 'application/json'
+            if block_given?
+              yield(request)
+            else
+              request['Content-Type'] = 'application/json'
+              request.body = convert(params) if %i[post patch].include?(method)
+            end
+
+            if client.access_token
+              request['Authorization'] = "Bearer #{client.access_token.token}"
+            else
+              request.basic_auth(client.username, client.password)
+            end
+            https.request(request)
+          end
         end
+        alias call request
 
-        return result.to_json
-      end
+        private
 
-      def self.send
-        begin
+        def send
           request = yield
           response = Response.new(request.read_body.to_s).results
 
           if Response.success?(request.code.to_i)
-            return response
-          elsif Response.deleted?(request.code.to_i)
-            return true
+            response
+          elsif Response.success_no_content?(request.code.to_i)
+            true
           else
             if Response.unauthorized?(request.code.to_i)
-              raise UnauthorizedException.new
+              raise UnauthorizedException
+            elsif Response.not_found?(request.code.to_i)
+              raise NotFoundException
             else
               if !response.fetch(:error, nil).nil?
                 case response[:error][:code]
-                  when  'Internal_CompanyNotFound'
-                    raise CompanyNotFoundException.new
-                  else
-                    raise ApiException.new("#{request.code} - #{response[:error][:code]} #{response[:error][:message]}")
+                when 'Internal_CompanyNotFound'
+                  raise CompanyNotFoundException
+                else
+                  raise ApiException, "#{request.code} - #{response[:error][:code]} #{response[:error][:message]}"
                 end
               else
-                raise ApiException.new("#{request.code} - API call failed")
+                raise ApiException, "#{request.code} - API call failed"
               end
             end
           end
@@ -77,4 +88,4 @@ module BusinessCentral
       end
     end
   end
-end
+end

data/lib/business_central/object/response.rb

@@ -1,35 +1,43 @@
+# frozen_string_literal: true
+
 module BusinessCentral
   module Object
     class Response
-      attr_reader :results
+      class << self
+        def success?(status)
+          [200, 201].include?(status)
+        end
 
-      def initialize(response)
-        @results = nil
-        if !response.blank?
-          @response = JSON.parse(response)
-          if @response.has_key?('value')
-            @response = @response['value']
-          end
-          process
+        def success_no_content?(status)
+          status == 204
         end
-      end
 
-      def self.success?(status)
-        status == 200 || status == 201
-      end
+        def unauthorized?(status)
+          status == 401
+        end
 
-      def self.deleted?(status)
-        status == 204
+        def not_found?(status)
+          status == 404
+        end
       end
 
-      def self.unauthorized?(status)
-        status == 401
+      attr_reader :results
+
+      def initialize(response)
+        @results = nil
+        return if response.blank?
+
+        @response = JSON.parse(response)
+        @response = @response['value'] if @response.key?('value')
+        process
       end
 
       private
 
       def process
-        if @response.is_a?(Array)
+        if @response.is_a?(String)
+          @results = @response
+        elsif @response.is_a?(Array)
           @results = []
           @response.each do |data|
             @results << convert(data)
@@ -40,11 +48,11 @@ module BusinessCentral
       end
 
       def convert(data)
-        result = {}    
+        result = {}
         data.each do |key, value|
-          if key == "@odata.etag"
+          if key == '@odata.etag'
             result[:etag] = value
-          elsif key == "@odata.context"
+          elsif key == '@odata.context'
             result[:context] = value
           elsif value.is_a?(Hash)
             result[key.to_snake_case.to_sym] = convert(value)
@@ -53,8 +61,8 @@ module BusinessCentral
           end
         end
 
-        return result
+        result
       end
     end
   end
-end
+end

data/lib/business_central/object/retained_earning_statement.rb

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+
+module BusinessCentral
+  module Object
+    class RetainedEarningStatement < Base
+      OBJECT = 'retainedEarningsStatement'
+
+      OBJECT_METHODS = %i[
+        get
+      ].freeze
+    end
+  end
+end

data/lib/business_central/object/sales_credit_memo.rb

@@ -0,0 +1,20 @@
+# frozen_string_literal: true
+
+module BusinessCentral
+  module Object
+    class SalesCreditMemo < Base
+      extend BusinessCentral::Object::ObjectHelper
+
+      OBJECT = 'salesCreditMemos'
+
+      OBJECT_METHODS = %i[
+        get
+        post
+        patch
+        delete
+      ].freeze
+
+      navigation :sales_credit_memo_line
+    end
+  end
+end

data/lib/business_central/object/sales_credit_memo_line.rb

@@ -0,0 +1,30 @@
+# frozen_string_literal: true
+
+module BusinessCentral
+  module Object
+    class SalesCreditMemoLine < Base
+      OBJECT = 'salesCreditMemoLines'
+
+      OBJECT_METHODS = %i[
+        get
+        post
+        patch
+        delete
+      ].freeze
+
+      OBJECT_PARENTS = %w[
+        salesCreditMemos
+      ].freeze
+
+      def initialize(client, parent: 'salesCreditMemos', parent_id:, **args)
+        return if !valid_parent?(parent)
+
+        super(client, args)
+        @parent_path << {
+          path: parent,
+          id: parent_id
+        }
+      end
+    end
+  end
+end