ledger_sync-quickbooks_online 0.1.1

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

@@ -0,0 +1,33 @@
+# frozen_string_literal: true
+
+require_relative '../reference/serializer'
+
+module LedgerSync
+  module QuickBooksOnline
+    class DepositLineDetail
+      class Serializer < QuickBooksOnline::Serializer
+        references_one 'AccountRef',
+                       resource_attribute: :Account,
+                       serializer: Reference::Serializer
+
+        references_one 'ClassRef',
+                       resource_attribute: :Class,
+                       serializer: Reference::Serializer
+
+        attribute '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
+      end
+    end
+  end
+end

data/lib/ledger_sync/quickbooks_online/deserializer.rb

@@ -0,0 +1,97 @@
+# frozen_string_literal: true
+
+# Gem.find_files('ledger_sync/ledgers/quickbooks_online/serializer_type/**/*.rb').each { |path| require path }
+
+module LedgerSync
+  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::QuickBooksOnline::Account) &&
+           deserialized_resource.AccountType &&
+           deserialized_resource.Classification.blank?
+          deserialized_resource.Classification = deserialized_resource.class::TYPES_TO_CLASSIFICATION_MAPPING.fetch(
+            deserialized_resource.AccountType,
+            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)
+        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

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

@@ -0,0 +1,52 @@
+# frozen_string_literal: true
+
+require_relative '../expense_line/deserializer'
+require_relative '../reference/deserializer'
+
+module LedgerSync
+  module QuickBooksOnline
+    class Expense
+      class Deserializer < QuickBooksOnline::Deserializer
+        id
+
+        attribute :DocNumber
+        date :TxnDate
+        attribute :PrivateNote
+
+        attribute :ExchangeRate
+
+        mapping :PaymentType,
+                hash: Expense::PAYMENT_TYPES.invert
+
+        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
+
+        references_one :Currency,
+                       hash_attribute: 'CurrencyRef',
+                       deserializer: Reference::Deserializer
+
+        references_one :Account,
+                       hash_attribute: 'AccountRef',
+                       deserializer: Reference::Deserializer
+
+        references_one :Department,
+                       hash_attribute: 'DepartmentRef',
+                       deserializer: Reference::Deserializer
+
+        references_many :Line,
+                        hash_attribute: 'Line',
+                        deserializer: ExpenseLine::Deserializer
+      end
+    end
+  end
+end

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

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

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

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

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

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

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

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

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

@@ -0,0 +1,51 @@
+# frozen_string_literal: true
+
+require_relative '../expense_line/serializer'
+require_relative '../reference/serializer'
+
+module LedgerSync
+  module QuickBooksOnline
+    class Expense
+      class Serializer < QuickBooksOnline::Serializer
+        id
+
+        attribute :DocNumber
+        date :TxnDate
+        attribute :PrivateNote
+        attribute :ExchangeRate
+
+        attribute :PaymentType,
+                  type: LedgerSync::Serialization::Type::MappingType.new(hash: Expense::PAYMENT_TYPES)
+
+        attribute('EntityRef') do |args = {}|
+          resource = args.fetch(:resource)
+          if resource.Entity
+            {
+              'name' => resource.Entity.name,
+              'value' => resource.Entity.ledger_id,
+              'type' => Client.ledger_resource_type_for(
+                resource_class: resource.Entity.class
+              ).classify
+            }
+          end
+        end
+
+        references_one 'CurrencyRef',
+                       resource_attribute: :Currency,
+                       serializer: Reference::Serializer
+
+        references_one 'AccountRef',
+                       resource_attribute: :Account,
+                       serializer: Reference::Serializer
+
+        references_one 'DepartmentRef',
+                       resource_attribute: :Department,
+                       serializer: Reference::Serializer
+
+        references_many 'Line',
+                        resource_attribute: :Line,
+                        serializer: ExpenseLine::Serializer
+      end
+    end
+  end
+end

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

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

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

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

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

@@ -0,0 +1,33 @@
+# frozen_string_literal: true
+
+require_relative '../invoice_line/deserializer'
+require_relative '../reference/deserializer'
+
+module LedgerSync
+  module QuickBooksOnline
+    class Invoice
+      class Deserializer < QuickBooksOnline::Deserializer
+        id
+
+        date :TxnDate
+        attribute :PrivateNote
+
+        references_one :Currency,
+                       hash_attribute: 'CurrencyRef',
+                       deserializer: Reference::Deserializer
+
+        references_one :Customer,
+                       hash_attribute: 'CustomerRef',
+                       deserializer: Reference::Deserializer
+
+        references_one :DepositToAccount,
+                       hash_attribute: 'DepositToAccountRef',
+                       deserialier: Reference::Deserializer
+
+        references_many :Line,
+                        hash_attribute: 'Line',
+                        deserializer: InvoiceLine::Deserializer
+      end
+    end
+  end
+end

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

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