ledger_sync-quickbooks_online 0.1.1

data/Rakefile

@@ -0,0 +1,8 @@
+# frozen_string_literal: true
+
+require 'bundler/gem_tasks'
+require 'rspec/core/rake_task'
+
+RSpec::Core::RakeTask.new(:spec)
+
+task default: :spec

data/bin/console

@@ -0,0 +1,15 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+require 'bundler/setup'
+require 'ledger_sync/quickbooks_online'
+
+# You can add fixtures and/or initialization code here to make experimenting
+# with your gem easier. You can also use a different console, if you like.
+
+# (If you use this, don't forget to add pry to your Gemfile!)
+# require "pry"
+# Pry.start
+
+require 'irb'
+IRB.start(__FILE__)

data/bin/quickbooks_online_oauth_server.rb

@@ -0,0 +1,104 @@
+# frozen_string_literal: true
+
+# Setup
+#
+# gem install bundler
+# Ensure you have http://localhost:5678 (or PORT) as a Redirect URI in QBO.
+
+require 'bundler/inline'
+
+gemfile do
+  source 'https://rubygems.org'
+  gem 'dotenv'
+  # gem 'ledger_sync'
+  gem 'ledger_sync-quickbooks_online', path: './'
+  gem 'rack'
+  gem 'pd_ruby'
+end
+
+puts 'Gems installed and loaded!'
+
+require 'pd_ruby'
+require 'socket'
+require 'dotenv'
+require 'rack'
+require 'ledger_sync/quickbooks_online'
+require 'rack/lobster'
+
+Dotenv.load('.env.local')
+
+port = ENV.fetch('PORT', 5678)
+server = TCPServer.new port
+
+base_url = "http://localhost:#{port}"
+
+puts "Listening at #{base_url}"
+
+client_id = ENV.fetch('QUICKBOOKS_ONLINE_CLIENT_ID')
+
+raise 'QUICKBOOKS_ONLINE_CLIENT_ID not set in ../.env' if client_id.blank?
+
+client = LedgerSync::QuickBooksOnline::Client.new_from_env(test: true)
+
+puts 'Go to the following URL:'
+puts client.authorization_url(redirect_uri: base_url)
+
+while (session = server.accept) # rubocop:disable Lint/UnreachableLoop
+  request = session.gets
+
+  puts request
+
+  # 1
+  _method, full_path = request.split
+
+  # 2
+  _path, query = full_path.split('?')
+
+  params = Hash[query.split('&').map { |e| e.split('=') }] if query.present?
+
+  client.set_credentials_from_oauth_code(
+    code: params.fetch('code'),
+    realm_id: params.fetch('realmId'),
+    redirect_uri: base_url
+  )
+
+  puts "\n"
+
+  puts 'access_token:'
+  puts client.access_token
+  puts "\n"
+  puts 'client_id:'
+  puts client.client_id
+  puts "\n"
+  puts 'client_secret:'
+  puts client.client_secret
+  puts "\n"
+  puts 'realm_id:'
+  puts client.realm_id
+  puts "\n"
+  puts 'refresh_token:'
+  puts client.refresh_token
+  puts "\n"
+
+  puts 'Done!'
+
+  status = 200
+  body = 'Done'
+  headers = {
+    'Content-Length' => body.size
+  }
+
+  session.print "HTTP/1.1 #{status}\r\n"
+
+  headers.each do |key, value|
+    session.print "#{key}: #{value}\r\n"
+  end
+
+  session.print "\r\n"
+
+  session.print body
+
+  session.close
+
+  break
+end

data/bin/setup

@@ -0,0 +1,8 @@
+#!/usr/bin/env bash
+set -euo pipefail
+IFS=$'\n\t'
+set -vx
+
+bundle install
+
+# Do any other automated setup that you need to do here

data/ledger_sync-quickbooks_online.gemspec

@@ -0,0 +1,46 @@
+# frozen_string_literal: true
+
+lib = File.expand_path('lib', __dir__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'ledger_sync/quickbooks_online/version'
+
+Gem::Specification.new do |spec|
+  spec.name = 'ledger_sync-quickbooks_online'
+  spec.version = LedgerSync::QuickBooksOnline::VERSION
+  spec.authors = ['Modern Treasury']
+  spec.email = ['ledgersync@moderntreasury.com']
+
+  spec.required_ruby_version = '>= 2.5.8'
+
+  spec.summary = 'Sync common objects to accounting software.'
+  spec.description = 'LedgerSync is a simple library that allows you to sync common objects to popular accounting '\
+                     'software like QuickBooks Online, QuickBooksOnline, NetSuite, etc.'
+  spec.homepage = 'https://www.ledgersync.dev'
+
+  # Specify which files should be added to the gem when it is released.
+  # The `git ls-files -z` loads the files in the RubyGem that have been added into git.
+  spec.files = Dir.chdir(File.expand_path(__dir__)) do
+    `git ls-files -z`.split("\x0").reject { |f| f.match(%r{^(test|spec|features)/}) }
+  end
+  spec.bindir        = 'exe'
+  spec.executables   = spec.files.grep(%r{^exe/}) { |f| File.basename(f) }
+  spec.require_paths = ['lib']
+
+  spec.add_development_dependency('awesome_print', '>= 0')
+  spec.add_development_dependency('bump', '~> 0.9.0')
+  spec.add_development_dependency('bundler', '~> 2.1')
+  spec.add_development_dependency('byebug')
+  spec.add_development_dependency('climate_control')
+  spec.add_development_dependency('coveralls')
+  spec.add_development_dependency('factory_bot', '~> 6.1.0')
+  spec.add_development_dependency('overcommit', '~> 0.57.0')
+  spec.add_development_dependency('rake', '~> 13.0')
+  spec.add_development_dependency('rspec', '~> 3.2')
+  spec.add_development_dependency('rubocop', '>= 0')
+  spec.add_development_dependency('vcr', '>= 0')
+  spec.add_development_dependency('webmock', '>= 0')
+  spec.add_runtime_dependency('dotenv')
+  spec.add_runtime_dependency('ledger_sync', '~> 1.8.0')
+  # spec.add_runtime_dependency('nokogiri', '>= 0')
+  spec.add_runtime_dependency('oauth2', '>= 0')
+end

data/lib/ledger_sync/quickbooks_online.rb

@@ -0,0 +1,14 @@
+# frozen_string_literal: true
+
+require 'ledger_sync'
+require 'oauth2'
+
+module LedgerSync
+  module QuickBooksOnline
+    def self.root(*paths)
+      File.join(File.expand_path('../..', __dir__), *paths.map(&:to_s))
+    end
+  end
+end
+
+require_relative 'quickbooks_online/config'

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

@@ -0,0 +1,29 @@
+# frozen_string_literal: true
+
+require_relative '../reference/deserializer'
+
+module LedgerSync
+  module QuickBooksOnline
+    class Account
+      class Deserializer < QuickBooksOnline::Deserializer
+        id
+
+        attribute :Name
+        attribute :AcctNum
+        attribute :Description
+        attribute :Active
+
+        mapping :AccountType,
+                hash: Account::TYPES.invert
+        mapping :AccountSubType,
+                hash: Account::SUB_TYPES.invert
+        mapping :Classification,
+                hash: Account::CLASSIFICATIONS.invert
+
+        references_one :Currency,
+                       hash_attribute: :CurrencyRef,
+                       deserializer: Reference::Deserializer
+      end
+    end
+  end
+end

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

@@ -0,0 +1,26 @@
+# frozen_string_literal: true
+
+module LedgerSync
+  module QuickBooksOnline
+    class Account
+      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(:AccountSubType).filled(:string)
+              required(:AccountType).filled(:string)
+              required(:AcctNum).maybe(:string)
+              required(:Active).maybe(:bool)
+              required(:Classification).filled(:string)
+              required(:Currency).maybe(:hash, Types::Reference)
+              required(:Description).maybe(:string)
+              required(:Name).filled(:string)
+            end
+          end
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,26 @@
+# frozen_string_literal: true
+
+module LedgerSync
+  module QuickBooksOnline
+    class Account
+      module Operations
+        class Find < Operation::Find
+          class Contract < LedgerSync::Ledgers::Contract
+            params do
+              required(:external_id).maybe(:string)
+              required(:ledger_id).filled(:string)
+              required(:AccountType).maybe(:string)
+              required(:AccountSubType).maybe(:string)
+              required(:AcctNum).maybe(:string)
+              required(:Active).maybe(:bool)
+              required(:Classification).maybe(:string)
+              required(:Currency).maybe(:hash, Types::Reference)
+              required(:Description).maybe(:string)
+              required(:Name).maybe(:string)
+            end
+          end
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,28 @@
+# frozen_string_literal: true
+
+# https://developer.intuit.com/app/developer/qbo/docs/api/accounting/all-entities/account
+# Requires full update
+module LedgerSync
+  module QuickBooksOnline
+    class Account
+      module Operations
+        class Update < Operation::FullUpdate
+          class Contract < LedgerSync::Ledgers::Contract
+            params do
+              required(:external_id).maybe(:string)
+              required(:ledger_id).filled(:string)
+              required(:AccountSubType).filled(:string)
+              required(:AccountType).filled(:string)
+              required(:AcctNum).maybe(:string)
+              required(:Active).maybe(:bool)
+              required(:Classification).filled(:string)
+              required(:Currency).maybe(:hash, Types::Reference)
+              required(:Description).maybe(:string)
+              required(:Name).filled(:string)
+            end
+          end
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+
+module LedgerSync
+  module QuickBooksOnline
+    class Account
+      class Searcher < Searcher
+        def query_string
+          "Name LIKE '%#{query}%'"
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,29 @@
+# frozen_string_literal: true
+
+require_relative '../reference/serializer'
+
+module LedgerSync
+  module QuickBooksOnline
+    class Account
+      class Serializer < QuickBooksOnline::Serializer
+        id
+
+        attribute :Name
+        attribute :AcctNum
+        attribute :Description
+        attribute :Active
+
+        mapping :AccountType,
+                hash: Account::TYPES
+        mapping :AccountSubType,
+                hash: Account::SUB_TYPES
+        mapping :Classification,
+                hash: Account::CLASSIFICATIONS
+
+        references_one :CurrencyRef,
+                       resource_attribute: :Currency,
+                       serializer: Reference::Serializer
+      end
+    end
+  end
+end

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

@@ -0,0 +1,19 @@
+# frozen_string_literal: true
+
+require_relative '../reference/deserializer'
+
+module LedgerSync
+  module QuickBooksOnline
+    class AccountBasedExpenseLineDetail
+      class Deserializer < QuickBooksOnline::Deserializer
+        references_one :Account,
+                       hash_attribute: 'AccountRef',
+                       deserializer: Reference::Deserializer
+
+        references_one :Class,
+                       hash_attribute: 'ClassRef',
+                       deserializer: Reference::Deserializer
+      end
+    end
+  end
+end

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

@@ -0,0 +1,19 @@
+# frozen_string_literal: true
+
+require_relative '../reference/serializer'
+
+module LedgerSync
+  module QuickBooksOnline
+    class AccountBasedExpenseLineDetail
+      class Serializer < QuickBooksOnline::Serializer
+        references_one 'AccountRef',
+                       resource_attribute: :Account,
+                       serializer: Reference::Serializer
+
+        references_one 'ClassRef',
+                       resource_attribute: :Class,
+                       serializer: Reference::Serializer
+      end
+    end
+  end
+end

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

@@ -0,0 +1,39 @@
+# frozen_string_literal: true
+
+require_relative '../bill_line/deserializer'
+require_relative '../reference/deserializer'
+
+module LedgerSync
+  module QuickBooksOnline
+    class Bill
+      class Deserializer < QuickBooksOnline::Deserializer
+        id
+
+        date :DueDate
+        date :TxnDate
+        attribute :PrivateNote
+        attribute :DocNumber
+
+        references_one :Currency,
+                       hash_attribute: 'CurrencyRef',
+                       deserializer: Reference::Deserializer
+
+        references_one :Vendor,
+                       hash_attribute: 'VendorRef',
+                       deserializer: Reference::Deserializer
+
+        references_one :APAccount,
+                       hash_attribute: 'APAccountRef',
+                       deserializer: Reference::Deserializer
+
+        references_one :Department,
+                       hash_attribute: 'DepartmentRef',
+                       deserializer: Reference::Deserializer
+
+        references_many :Line,
+                        hash_attribute: 'Line',
+                        deserializer: BillLine::Deserializer
+      end
+    end
+  end
+end