ledger_sync-quickbooks_online 0.1.1

data/lib/ledger_sync/quickbooks_online/customer/serializer.rb

@@ -0,0 +1,24 @@
+# frozen_string_literal: true
+
+require_relative '../primary_phone/serializer'
+require_relative '../primary_email_addr/serializer'
+
+module LedgerSync
+  module QuickBooksOnline
+    class Customer
+      class Serializer < QuickBooksOnline::Serializer
+        id
+
+        attribute :DisplayName
+        attribute :GivenName
+        attribute :FamilyName
+        attribute :MiddleName
+
+        references_one :PrimaryPhone,
+                       serializer: PrimaryPhone::Serializer
+        references_one :PrimaryEmailAddr,
+                       serializer: PrimaryEmailAddr::Serializer
+      end
+    end
+  end
+end

data/lib/ledger_sync/quickbooks_online/dashboard_url_helper.rb

@@ -0,0 +1,32 @@
+# frozen_string_literal: true
+
+module LedgerSync
+  module QuickBooksOnline
+    class DashboardURLHelper < LedgerSync::Ledgers::DashboardURLHelper
+      def resource_path # rubocop:disable Metrics/CyclomaticComplexity
+        @resource_path = case resource
+                         when QuickBooksOnline::Account
+                           "/register?accountId=#{resource.ledger_id}"
+                         when QuickBooksOnline::Bill
+                           "/bill?txnId=#{resource.ledger_id}"
+                         when QuickBooksOnline::Customer
+                           "/customerdetail?nameId=#{resource.ledger_id}"
+                         when QuickBooksOnline::Deposit
+                           "/deposit?txnId=#{resource.ledger_id}"
+                         when QuickBooksOnline::Expense
+                           "/expense?txnId=#{resource.ledger_id}"
+                         when QuickBooksOnline::JournalEntry
+                           "/journal?txnId=#{resource.ledger_id}"
+                         when QuickBooksOnline::LedgerClass
+                           '/class'
+                         when QuickBooksOnline::Payment
+                           "/recvpayment?txnId=#{resource.ledger_id}"
+                         when QuickBooksOnline::Transfer
+                           "/transfer?txnId=#{resource.ledger_id}"
+                         when QuickBooksOnline::Vendor
+                           "/vendordetail?nameId=#{resource.ledger_id}"
+                         end
+      end
+    end
+  end
+end

data/lib/ledger_sync/quickbooks_online/department/deserializer.rb

@@ -0,0 +1,20 @@
+# frozen_string_literal: true
+
+module LedgerSync
+  module QuickBooksOnline
+    class Department
+      class Deserializer < QuickBooksOnline::Deserializer
+        id
+
+        attribute :Name
+        attribute :Active
+        attribute :SubDepartment
+        attribute :FullyQualifiedName
+
+        references_one :Parent,
+                       hash_attribute: 'ParentRef',
+                       deserializer: Reference::Deserializer
+      end
+    end
+  end
+end

data/lib/ledger_sync/quickbooks_online/department/operations/create.rb

@@ -0,0 +1,23 @@
+# frozen_string_literal: true
+
+module LedgerSync
+  module QuickBooksOnline
+    class Department
+      module Operations
+        class Create < QuickBooksOnline::Operation::Create
+          class Contract < LedgerSync::Ledgers::Contract
+            params do
+              required(:external_id).maybe(:string)
+              required(:ledger_id).value(:nil)
+              required(:Name).filled(:string)
+              required(:Active).filled(:bool?)
+              required(:SubDepartment).filled(:bool?)
+              optional(:FullyQualifiedName).maybe(:string)
+              optional(:Parent).maybe(:hash, Types::Reference)
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/ledger_sync/quickbooks_online/department/operations/find.rb

@@ -0,0 +1,23 @@
+# frozen_string_literal: true
+
+module LedgerSync
+  module QuickBooksOnline
+    class Department
+      module Operations
+        class Find < QuickBooksOnline::Operation::Find
+          class Contract < LedgerSync::Ledgers::Contract
+            params do
+              required(:external_id).maybe(:string)
+              required(:ledger_id).filled(:string)
+              optional(:Name).maybe(:string)
+              optional(:Active).maybe(:bool?)
+              optional(:SubDepartment).maybe(:bool?)
+              optional(:FullyQualifiedName).maybe(:string)
+              optional(:Parent).maybe(:hash, Types::Reference)
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/ledger_sync/quickbooks_online/department/operations/update.rb

@@ -0,0 +1,23 @@
+# frozen_string_literal: true
+
+module LedgerSync
+  module QuickBooksOnline
+    class Department
+      module Operations
+        class Update < QuickBooksOnline::Operation::FullUpdate
+          class Contract < LedgerSync::Ledgers::Contract
+            params do
+              required(:external_id).maybe(:string)
+              required(:ledger_id).filled(:string)
+              required(:Name).filled(:string)
+              required(:Active).filled(:bool?)
+              required(:SubDepartment).filled(:bool?)
+              optional(:FullyQualifiedName).maybe(:string)
+              optional(:Parent).maybe(:hash, Types::Reference)
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/ledger_sync/quickbooks_online/department/searcher.rb

@@ -0,0 +1,15 @@
+# frozen_string_literal: true
+
+module LedgerSync
+  module QuickBooksOnline
+    class Department
+      class Searcher < Searcher
+        private
+
+        def query_string
+          @query_string ||= "Name LIKE '%#{query}%'"
+        end
+      end
+    end
+  end
+end

data/lib/ledger_sync/quickbooks_online/department/serializer.rb

@@ -0,0 +1,39 @@
+# frozen_string_literal: true
+
+require_relative '../reference/serializer'
+
+module LedgerSync
+  module QuickBooksOnline
+    class Department
+      class Serializer < QuickBooksOnline::Serializer
+        id
+
+        attribute :Name
+        attribute :Active
+        attribute :SubDepartment
+        attribute :FullyQualifiedName
+
+        references_one 'ParentRef',
+                       resource_attribute: :Parent,
+                       serializer: Reference::Serializer
+
+        # Sending "ParentRef": {"value": null} results in QBO API crash
+        # This patches serialized hash to exclude it unless we don't set value
+        def serialize(args = {})
+          deep_merge_unmapped_values = args.fetch(:deep_merge_unmapped_values, {})
+          only_changes = args.fetch(:only_changes, false)
+          resource = args.fetch(:resource)
+
+          ret = super(only_changes: only_changes, resource: resource)
+
+          return ret unless deep_merge_unmapped_values.any?
+
+          deep_merge_if_not_mapped(
+            current_hash: ret,
+            hash_to_search: deep_merge_unmapped_values
+          )
+        end
+      end
+    end
+  end
+end

data/lib/ledger_sync/quickbooks_online/deposit/deserializer.rb

@@ -0,0 +1,34 @@
+# frozen_string_literal: true
+
+require_relative '../deposit_line/deserializer'
+require_relative '../reference/deserializer'
+
+module LedgerSync
+  module QuickBooksOnline
+    class Deposit
+      class Deserializer < QuickBooksOnline::Deserializer
+        id
+
+        date :TxnDate
+        attribute :PrivateNote
+        attribute :ExchangeRate
+
+        references_one :Currency,
+                       hash_attribute: 'CurrencyRef',
+                       deserializer: Reference::Deserializer
+
+        references_one :DepositToAccount,
+                       hash_attribute: 'DepositToAccountRef',
+                       deserializer: Reference::Deserializer
+
+        references_one :Department,
+                       hash_attribute: 'DepartmentRef',
+                       deserializer: Reference::Deserializer
+
+        references_many :Line,
+                        hash_attribute: 'Line',
+                        deserializer: DepositLine::Deserializer
+      end
+    end
+  end
+end

data/lib/ledger_sync/quickbooks_online/deposit/operations/create.rb

@@ -0,0 +1,25 @@
+# frozen_string_literal: true
+
+module LedgerSync
+  module QuickBooksOnline
+    class Deposit
+      module Operations
+        class Create < QuickBooksOnline::Operation::Create
+          class Contract < LedgerSync::Ledgers::Contract
+            params do
+              required(:external_id).maybe(:string)
+              required(:ledger_id).value(:nil)
+              required(:DepositToAccount).hash(Types::Reference)
+              required(:Currency).filled(:hash, Types::Reference)
+              required(:Department).hash(Types::Reference)
+              required(:PrivateNote).filled(:string)
+              required(:TxnDate).filled(:date?)
+              required(:ExchangeRate).maybe(:float)
+              required(:Line).array(Types::Reference)
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/ledger_sync/quickbooks_online/deposit/operations/find.rb

@@ -0,0 +1,25 @@
+# frozen_string_literal: true
+
+module LedgerSync
+  module QuickBooksOnline
+    class Deposit
+      module Operations
+        class Find < QuickBooksOnline::Operation::Find
+          class Contract < LedgerSync::Ledgers::Contract
+            schema do
+              required(:external_id).maybe(:string)
+              required(:ledger_id).filled(:string)
+              optional(:DepositToAccount).hash(Types::Reference)
+              optional(:Currency).maybe(:hash, Types::Reference)
+              optional(:Department).hash(Types::Reference)
+              optional(:PrivateNote).maybe(:string)
+              optional(:TxnDate).filled(:date?)
+              optional(:ExchangeRate).maybe(:float)
+              optional(:Line).array(Types::Reference)
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/ledger_sync/quickbooks_online/deposit/operations/update.rb

@@ -0,0 +1,25 @@
+# frozen_string_literal: true
+
+module LedgerSync
+  module QuickBooksOnline
+    class Deposit
+      module Operations
+        class Update < QuickBooksOnline::Operation::FullUpdate
+          class Contract < LedgerSync::Ledgers::Contract
+            schema do
+              required(:external_id).maybe(:string)
+              required(:ledger_id).filled(:string)
+              required(:DepositToAccount).hash(Types::Reference)
+              required(:Currency).filled(:hash, Types::Reference)
+              required(:Department).hash(Types::Reference)
+              required(:PrivateNote).filled(:string)
+              required(:TxnDate).filled(:date?)
+              required(:ExchangeRate).maybe(:float)
+              required(:Line).array(Types::Reference)
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/ledger_sync/quickbooks_online/deposit/searcher.rb

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+require_relative '../searcher'
+
+module LedgerSync
+  module QuickBooksOnline
+    class Deposit
+      class Searcher < Searcher
+      end
+    end
+  end
+end

data/lib/ledger_sync/quickbooks_online/deposit/serializer.rb

@@ -0,0 +1,34 @@
+# frozen_string_literal: true
+
+require_relative '../deposit_line/serializer'
+require_relative '../reference/serializer'
+
+module LedgerSync
+  module QuickBooksOnline
+    class Deposit
+      class Serializer < QuickBooksOnline::Serializer
+        id
+
+        date :TxnDate
+        attribute :PrivateNote
+        attribute :ExchangeRate
+
+        references_one 'CurrencyRef',
+                       resource_attribute: :Currency,
+                       serializer: Reference::Serializer
+
+        references_one 'DepositToAccountRef',
+                       resource_attribute: :DepositToAccount,
+                       serializer: Reference::Serializer
+
+        references_one 'DepartmentRef',
+                       resource_attribute: :Department,
+                       serializer: Reference::Serializer
+
+        references_many 'Line',
+                        resource_attribute: :Line,
+                        serializer: DepositLine::Serializer
+      end
+    end
+  end
+end

data/lib/ledger_sync/quickbooks_online/deposit_line/deserializer.rb

@@ -0,0 +1,20 @@
+# frozen_string_literal: true
+
+require_relative '../deposit_line_detail/deserializer'
+
+module LedgerSync
+  module QuickBooksOnline
+    class DepositLine
+      class Deserializer < QuickBooksOnline::Deserializer
+        id
+
+        amount :Amount
+        attribute :Description
+
+        references_one :DepositLineDetail,
+                       hash_attribute: 'DepositLineDetail',
+                       deserializer: DepositLineDetail::Deserializer
+      end
+    end
+  end
+end

data/lib/ledger_sync/quickbooks_online/deposit_line/serializer.rb

@@ -0,0 +1,24 @@
+# frozen_string_literal: true
+
+require_relative '../deposit_line_detail/serializer'
+
+module LedgerSync
+  module QuickBooksOnline
+    class DepositLine
+      class Serializer < QuickBooksOnline::Serializer
+        id
+
+        amount :Amount
+        attribute :Description
+
+        attribute :DetailType do
+          'DepositLineDetail'
+        end
+
+        references_one 'DepositLineDetail',
+                       resource_attribute: :DepositLineDetail,
+                       serializer: DepositLineDetail::Serializer
+      end
+    end
+  end
+end

data/lib/ledger_sync/quickbooks_online/deposit_line_detail/deserializer.rb

@@ -0,0 +1,32 @@
+# frozen_string_literal: true
+
+require_relative '../reference/deserializer'
+
+module LedgerSync
+  module QuickBooksOnline
+    class DepositLineDetail
+      class Deserializer < QuickBooksOnline::Deserializer
+        references_one :Account,
+                       hash_attribute: 'AccountRef',
+                       deserializer: Reference::Deserializer
+
+        references_one :Class,
+                       hash_attribute: 'ClassRef',
+                       deserializer: Reference::Deserializer
+
+        attribute(:Entity) do |args = {}|
+          hash = args.fetch(:hash)
+          value = hash.fetch('Entity', nil)
+
+          unless value.nil?
+            Client.ledger_resource_for(
+              type: value['type']
+            ).new(
+              ledger_id: value['value']
+            )
+          end
+        end
+      end
+    end
+  end
+end