ledger_sync 1.3.4 → 1.4.4

data/lib/ledger_sync/{adaptors → ledgers}/quickbooks_online/department/operations/update.rb

@@ -1,12 +1,12 @@
 # frozen_string_literal: true
 
 module LedgerSync
-  module Adaptors
+  module Ledgers
     module QuickBooksOnline
-      module Department
+      class Department
         module Operations
           class Update < QuickBooksOnline::Operation::FullUpdate
-            class Contract < LedgerSync::Adaptors::Contract
+            class Contract < LedgerSync::Ledgers::Contract
               params do
                 required(:external_id).maybe(:string)
                 required(:ledger_id).filled(:string)

data/lib/ledger_sync/{adaptors → ledgers}/quickbooks_online/department/searcher.rb

@@ -1,10 +1,10 @@
 # frozen_string_literal: true
 
 module LedgerSync
-  module Adaptors
+  module Ledgers
     module QuickBooksOnline
-      module Department
-        class Searcher < LedgerSync::Adaptors::QuickBooksOnline::Searcher
+      class Department
+        class Searcher < LedgerSync::Ledgers::QuickBooksOnline::Searcher
           private
 
           def query_string

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

@@ -0,0 +1,49 @@
+# frozen_string_literal: true
+
+module LedgerSync
+  module Ledgers
+    module QuickBooksOnline
+      class Department
+        class Serializer < QuickBooksOnline::Serializer
+          id
+
+          attribute 'Name',
+                    resource_attribute: :name
+          attribute 'Active',
+                    resource_attribute: :active
+          attribute 'SubDepartment',
+                    resource_attribute: :sub_department
+          attribute 'FullyQualifiedName',
+                    resource_attribute: :fully_qualified_name
+
+          attribute(:ParentRef) do |args = {}|
+            resource = args.fetch(:resource)
+
+            if resource.parent.present?
+              {
+                'value' => resource.parent.ledger_id
+              }
+            end
+          end
+
+          # 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
+end

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

@@ -0,0 +1,39 @@
+# frozen_string_literal: true
+
+require_relative '../deposit_line_item/deserializer'
+require_relative '../currency/deserializer'
+
+module LedgerSync
+  module Ledgers
+    module QuickBooksOnline
+      class Deposit
+        class Deserializer < QuickBooksOnline::Deserializer
+          id
+
+          references_one :currency,
+                         hash_attribute: :CurrencyRef,
+                         deserializer: Currency::Deserializer
+
+          date :transaction_date,
+               hash_attribute: 'TxnDate'
+
+          attribute :memo,
+                    hash_attribute: 'PrivateNote'
+
+          attribute :exchange_rate,
+                    hash_attribute: 'ExchangeRate'
+
+          attribute 'account.ledger_id',
+                    hash_attribute: 'DepositToAccountRef.value'
+
+          attribute 'department.ledger_id',
+                    hash_attribute: 'DepartmentRef.value'
+
+          references_many :line_items,
+                          hash_attribute: 'Line',
+                          deserializer: DepositLineItem::Deserializer
+        end
+      end
+    end
+  end
+end

data/lib/ledger_sync/{adaptors → ledgers}/quickbooks_online/deposit/operations/create.rb

@@ -1,10 +1,12 @@
+# frozen_string_literal: true
+
 module LedgerSync
-  module Adaptors
+  module Ledgers
     module QuickBooksOnline
-      module Deposit
+      class Deposit
         module Operations
           class Create < QuickBooksOnline::Operation::Create
-            class Contract < LedgerSync::Adaptors::Contract
+            class Contract < LedgerSync::Ledgers::Contract
               params do
                 required(:external_id).maybe(:string)
                 required(:ledger_id).value(:nil)

data/lib/ledger_sync/{adaptors → ledgers}/quickbooks_online/deposit/operations/find.rb

@@ -1,10 +1,12 @@
+# frozen_string_literal: true
+
 module LedgerSync
-  module Adaptors
+  module Ledgers
     module QuickBooksOnline
-      module Deposit
+      class Deposit
         module Operations
           class Find < QuickBooksOnline::Operation::Find
-            class Contract < LedgerSync::Adaptors::Contract
+            class Contract < LedgerSync::Ledgers::Contract
               schema do
                 required(:external_id).maybe(:string)
                 required(:ledger_id).filled(:string)

data/lib/ledger_sync/{adaptors → ledgers}/quickbooks_online/deposit/operations/update.rb

@@ -1,12 +1,12 @@
 # frozen_string_literal: true
 
 module LedgerSync
-  module Adaptors
+  module Ledgers
     module QuickBooksOnline
-      module Deposit
+      class Deposit
         module Operations
           class Update < QuickBooksOnline::Operation::FullUpdate
-            class Contract < LedgerSync::Adaptors::Contract
+            class Contract < LedgerSync::Ledgers::Contract
               schema do
                 required(:external_id).maybe(:string)
                 required(:ledger_id).filled(:string)

data/lib/ledger_sync/{adaptors/quickbooks_online/expense → ledgers/quickbooks_online/deposit}/searcher.rb

@@ -3,9 +3,9 @@
 require_relative '../searcher'
 
 module LedgerSync
-  module Adaptors
+  module Ledgers
     module QuickBooksOnline
-      module Expense
+      class Deposit
         class Searcher < QuickBooksOnline::Searcher
         end
       end

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

@@ -0,0 +1,39 @@
+# frozen_string_literal: true
+
+require_relative '../deposit_line_item/serializer'
+require_relative '../currency/serializer'
+
+module LedgerSync
+  module Ledgers
+    module QuickBooksOnline
+      class Deposit
+        class Serializer < QuickBooksOnline::Serializer
+          id
+
+          references_one :CurrencyRef,
+                         resource_attribute: :currency,
+                         serializer: Currency::Serializer
+
+          date 'TxnDate',
+               resource_attribute: :transaction_date
+
+          attribute 'PrivateNote',
+                    resource_attribute: :memo
+
+          attribute 'ExchangeRate',
+                    resource_attribute: :exchange_rate
+
+          attribute 'DepositToAccountRef.value',
+                    resource_attribute: 'account.ledger_id'
+
+          attribute 'DepartmentRef.value',
+                    resource_attribute: 'department.ledger_id'
+
+          references_many 'Line',
+                          resource_attribute: :line_items,
+                          serializer: DepositLineItem::Serializer
+        end
+      end
+    end
+  end
+end

data/lib/ledger_sync/ledgers/quickbooks_online/deposit_line_item/deserializer.rb

@@ -0,0 +1,38 @@
+# frozen_string_literal: true
+
+module LedgerSync
+  module Ledgers
+    module QuickBooksOnline
+      class DepositLineItem
+        class Deserializer < QuickBooksOnline::Deserializer
+          id
+
+          attribute 'account.ledger_id',
+                    hash_attribute: 'DepositLineDetail.AccountRef.value'
+
+          attribute 'ledger_class.ledger_id',
+                    hash_attribute: 'DepositLineDetail.ClassRef.value'
+
+          attribute(:entity) do |args = {}|
+            hash = args.fetch(:hash)
+            value = hash.fetch('DepositLineDetail.Entity', nil)
+
+            unless value.nil?
+              Client.ledger_resource_for(
+                type: value['type']
+              ).new(
+                ledger_id: value['value']
+              )
+            end
+          end
+
+          amount :amount,
+                 hash_attribute: 'Amount'
+
+          attribute :description,
+                    hash_attribute: 'Description'
+        end
+      end
+    end
+  end
+end

data/lib/ledger_sync/ledgers/quickbooks_online/deposit_line_item/serializer.rb

@@ -0,0 +1,41 @@
+# frozen_string_literal: true
+
+module LedgerSync
+  module Ledgers
+    module QuickBooksOnline
+      class DepositLineItem
+        class Serializer < QuickBooksOnline::Serializer
+          id
+
+          attribute('DetailType') { 'DepositLineDetail' }
+
+          attribute 'DepositLineDetail.AccountRef.value',
+                    resource_attribute: 'account.ledger_id'
+
+          attribute 'DepositLineDetail.ClassRef.value',
+                    resource_attribute: 'ledger_class.ledger_id'
+
+          attribute('DepositLineDetail.Entity') do |args = {}|
+            resource = args.fetch(:resource)
+
+            if resource.entity.present?
+              {
+                'name' => resource.entity.name,
+                'value' => resource.entity.ledger_id,
+                'type' => Client.ledger_resource_type_for(
+                  resource_class: resource.entity.class
+                ).classify
+              }
+            end
+          end
+
+          amount 'Amount',
+                 resource_attribute: :amount
+
+          attribute 'Description',
+                    resource_attribute: :description
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,100 @@
+# frozen_string_literal: true
+
+# Gem.find_files('ledger_sync/ledgers/quickbooks_online/serializer_type/**/*.rb').each { |path| require path }
+
+module LedgerSync
+  module Ledgers
+    module QuickBooksOnline
+      class Deserializer < LedgerSync::Deserializer
+        def deserialize(args = {})
+          hash                  = args.fetch(:hash)
+          merge_for_full_update = args.fetch(:merge_for_full_update, false)
+          resource              = args.fetch(:resource)
+
+          deserialized_resource = super(hash: hash, resource: resource)
+
+          # Ref: https://github.com/LedgerSync/ledger_sync/issues/86
+          if deserialized_resource.is_a?(LedgerSync::Ledgers::QuickBooksOnline::Account) &&
+             deserialized_resource.account_type &&
+             deserialized_resource.classification.blank?
+            deserialized_resource.classification = deserialized_resource.class::TYPES_TO_CLASSIFICATION_MAPPING.fetch(
+              deserialized_resource.account_type,
+              nil
+            )
+          end
+
+          return deserialized_resource unless merge_for_full_update
+
+          merge_resources_for_full_update(
+            hash: hash,
+            ledger_resource: deserialized_resource,
+            resource: resource
+          )
+        end
+
+        def merge_resources_for_full_update(args = {})
+          hash            = args.fetch(:hash)
+          ledger_resource = args.fetch(:ledger_resource)
+          resource        = args.fetch(:resource)
+          merged_resource = resource.dup
+
+          self.class.attributes.each do |_key, deserializer_attribute|
+            next unless deserializer_attribute.references_many?
+
+            resources_from_ledger = attribute_value_from_ledger(
+              hash: hash,
+              deserializer_attribute: deserializer_attribute,
+              resource: merged_resource
+            )
+
+            resource_hash_from_ledger = Hash[resources_from_ledger.map { |e| [e.ledger_id, e] }]
+
+            # Using original resource since it is overwritten by keyword arg
+            merged_value = resource.send(deserializer_attribute.resource_attribute_dot_parts.first).map do |referenced|
+              if referenced.ledger_id.nil? # Assume creating a new resource in ledger
+                referenced
+              elsif resource_hash_from_ledger.key?(referenced.ledger_id.to_s) # Merged ledger into local
+                ledger_resource = resource_hash_from_ledger[referenced.ledger_id.to_s]
+                ledger_resource_serializer = deserializer_attribute.type.deserializer.inferred_serializer_class.new
+                deserializer_attribute.type.deserializer.new.deserialize(
+                  hash: ledger_resource_serializer.serialize(resource: ledger_resource),
+                  resource: referenced
+                )
+              end
+              # Else assume delete from ledger
+            end.compact
+
+            merged_resource.assign_attribute(
+              deserializer_attribute.resource_attribute_dot_parts.first,
+              merged_value
+            )
+          end
+
+          merged_resource
+        end
+
+        def self.amount(resource_attribute, args = {})
+          attribute(
+            resource_attribute,
+            {
+              type: Serialization::Type::AmountFloatToIntegerType.new
+            }.merge(args)
+          )
+        end
+
+        def self.date(resource_attribute, args = {})
+          attribute(
+            resource_attribute,
+            {
+              type: LedgerSync::Serialization::Type::ParseDateType.new(format: '%Y-%m-%d')
+            }.merge(args)
+          )
+        end
+
+        def self.id
+          attribute(:ledger_id, hash_attribute: 'Id')
+        end
+      end
+    end
+  end
+end

data/lib/ledger_sync/ledgers/quickbooks_online/expense/deserializer.rb

@@ -0,0 +1,59 @@
+# frozen_string_literal: true
+
+require_relative '../expense_line_item/deserializer'
+require_relative '../currency/deserializer'
+
+module LedgerSync
+  module Ledgers
+    module QuickBooksOnline
+      class Expense
+        class Deserializer < QuickBooksOnline::Deserializer
+          id
+
+          references_one :currency,
+                         hash_attribute: :CurrencyRef,
+                         deserializer: Currency::Deserializer
+
+          mapping :payment_type,
+                  hash_attribute: 'PaymentType',
+                  hash: Expense::PAYMENT_TYPES.invert
+
+          date :transaction_date,
+               hash_attribute: 'TxnDate'
+
+          attribute :memo,
+                    hash_attribute: 'PrivateNote'
+
+          attribute :exchange_rate,
+                    hash_attribute: 'ExchangeRate'
+
+          attribute(:entity) do |args = {}|
+            hash = args.fetch(:hash)
+            value = hash['EntityRef']
+
+            unless value.nil?
+              Client.resource_from_ledger_type(
+                type: value['type']
+              ).new(
+                ledger_id: value['value']
+              )
+            end
+          end
+
+          attribute :reference_number,
+                    hash_attribute: 'DocNumber'
+
+          attribute 'account.ledger_id',
+                    hash_attribute: 'AccountRef.value'
+
+          attribute 'department.ledger_id',
+                    hash_attribute: 'DepartmentRef.value'
+
+          references_many :line_items,
+                          hash_attribute: 'Line',
+                          deserializer: ExpenseLineItem::Deserializer
+        end
+      end
+    end
+  end
+end