effective_qb_online 0.7.0 → 0.7.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 842a17b9ed39140d60b1e8d579a6a8ac73e7ccb44fc9c977afe71fd7ba6f7566
-  data.tar.gz: 5d9aa52fcd52d31d1b13c4fae7b48fefdca77da9a737bf2881c8bc0c19c4332e
+  metadata.gz: 15867b1dfe0acb70639a0d07a4f772288659f3bbb48161fc95587f13c4709365
+  data.tar.gz: 7836486e1ca0178fb7defd247a5e338a78f9124e1e401fc28e29f1b1da175b0c
 SHA512:
-  metadata.gz: 8f24c8045da3be2527514640de6d2f62985a0f5d16299eeed5775cb3c96ed5a745ce53808df6027b044e33947db41d296e077f9d1cb846cac6636446781da82a
-  data.tar.gz: 1d84f06fccbc0570ffce4470c046ce12c4b3d58a345e9d37a625b1a6721536b1126504287b928303e26bd8278a10bcdd13aa9bb9dbc89c069ceb351c261930c7
+  metadata.gz: e9876ee172702a699a7892957df6a8f129c2b4045a9a4ce66ab1f0b1162eb6c5bdd2b06339afbb61f13f78bf14c79d0f024a3228070d19b83f6a5aa0104d2bb7
+  data.tar.gz: 6b41207fbf79478358b629fb329521e0b9b7c8c819ff914cf632e82d73d618bf9bd8ef5ccdf2ad088bbb7d1456b80977bf8520fd3abce4797a047e5f14c5728b

data/app/mailers/effective/qb_online_mailer.rb

@@ -0,0 +1,19 @@
+module Effective
+  class QbOnlineMailer < EffectiveQbOnline.parent_mailer_class
+    include EffectiveMailer
+
+    def sync_error(resource, opts = {})
+      raise('expected an Effective::QbReceipt') unless resource.kind_of?(Effective::QbReceipt)
+
+      @qb_receipt = resource
+      @order = resource.order
+
+      to = EffectiveOrders.qb_online_sync_error_recipients.presence || EffectiveOrders.mailer_admin
+      subject = subject_for(__method__, "Quickbooks Sync Error - Order ##{@order.to_param}", resource, opts)
+      headers = headers_for(resource, opts)
+
+      mail(to: to, subject: subject, **headers)
+    end
+
+  end
+end

data/app/models/effective/qb_receipt.rb

@@ -74,7 +74,7 @@ module Effective
         assign_attributes(result: 'completed successfully', sales_receipt_id: sales_receipt.id)
         complete!
       rescue => e
-        result = [e.message, *("(intuit_tid: #{e.intuit_tid})" if e.try(:intuit_tid).present?), e.backtrace.first(15).join("\n\n")].join(' ')
+        result = [e.message, ("(intuit_tid: #{e.intuit_tid})" if e.try(:intuit_tid).present?), e.backtrace.first(15)].compact.flatten.join("\n\n")
         assign_attributes(result: result)
         error!
       end
@@ -93,6 +93,7 @@ module Effective
     def error!
       errored!
       EffectiveLogger.error(result, associated: self) if defined?(EffectiveLogger)
+      EffectiveQbOnline.send_email(:sync_error, self)
 
       false
     end

data/app/views/effective/qb_online_mailer/sync_error.html.haml

@@ -0,0 +1,44 @@
+%p An error occurred while synchronizing Order ##{@order.to_param} to Quickbooks Online
+
+%div
+  %strong Error Message
+= simple_format(@qb_receipt.result)
+
+%div
+  %strong= "Order ##{@order.to_param}"
+  %br
+  = @order.created_at
+  %br
+  = @order.billing_name
+%p
+  - @order.order_items.each do |oi|
+    = "#{oi.name} (#{oi.try(:qb_item_name)})"
+    %br
+
+%p
+  %strong Resolution Steps
+  %br
+
+  - if @qb_receipt.result.to_s.include?('Duplicate Name Exists')
+    %ul
+      %li This customer could not be created because they share a name with an existing Item Name. This could be as a Vendor, Product, or Service.
+      %li Search QuickBooks for the non-customer item name and rename it. Ex: rename "John Doe" to "John Doe (Vendor)"
+      %li Re-run the QuickBooks Sync
+  - elsif @qb_receipt.result.to_s.include?('Unknown Item')
+    %ul
+      %li Confirm the QuickBooks Item Names for this Order within QuickBooks
+      %li If this Item Name does not exist, add it to QuickBooks
+      %li Otherwise, #{link_to('click here', effective_qb_online.edit_admin_qb_receipt_url(@qb_receipt))} to assign the correct Item Name to this Order
+      %li Re-run the QuickBooks Sync
+  - else
+    %ul
+      %li This is an error without a predefined resolution.
+      %li Please contact support.
+
+%hr
+
+%p{style: "text-align: center;"}
+  = link_to "View Quickbooks Sales Receipts", effective_qb_online.admin_quickbooks_url
+
+%p{style: "text-align: center;"}
+  = link_to "View Order ##{@order.to_param}", effective_orders.admin_order_url(@order)

data/config/effective_qb_online.rb

@@ -12,8 +12,18 @@ EffectiveQbOnline.setup do |config|
   # https://github.com/ruckus/quickbooks-ruby
   Quickbooks.sandbox_mode = (ENV['QUICKBOOKS_ONLINE_SANDBOX'].to_s == 'true')
 
-  # Effective Orders
-  # Add the following to your config/intializers/effective_orders.rb
-  # config.use_effective_qb_online = true
-
+  # Mailer Settings
+  # Please see config/initializers/effective_resources.rb for default effective_* gem mailer settings
+  #
+  # Configure the class responsible to send e-mails.
+  # config.mailer = 'Effective::QbOnlineMailer'
+  #
+  # Override effective_resource mailer defaults
+  #
+  # config.parent_mailer = nil      # The parent class responsible for sending emails
+  # config.deliver_method = nil     # The deliver method, deliver_later or deliver_now
+  # config.mailer_layout = nil      # Default mailer layout
+  # config.mailer_sender = nil      # Default From value
+  # config.mailer_admin = nil       # Default To value for Admin correspondence
+  # config.mailer_subject = nil     # Proc.new method used to customize Subject
 end

data/db/migrate/101_create_effective_qb_online.rb

@@ -1,11 +1,10 @@
 class CreateEffectiveQbOnline < ActiveRecord::Migration[6.0]
   def change
-    create_table :qb_realms do |t|
+    create_table :qb_realms, if_not_exists: true do |t|
       t.string :realm_id
 
-      t.integer :deposit_to_account_id
-      t.integer :payment_method_id
-      t.boolean :order_number_as_transaction_number, default: false
+      t.string :deposit_to_account_id
+      t.string :payment_method_id
 
       t.text :access_token
       t.datetime :access_token_expires_at
@@ -13,12 +12,16 @@ class CreateEffectiveQbOnline < ActiveRecord::Migration[6.0]
       t.text :refresh_token
       t.datetime :refresh_token_expires_at
 
+      t.boolean :order_number_as_transaction_number, default: false
+
       t.timestamps
     end
 
-    create_table :qb_receipts do |t|
+    create_table :qb_receipts, if_not_exists: true do |t|
       t.integer :order_id
-      t.integer :customer_id
+
+      t.string :customer_id
+      t.string :sales_receipt_id
 
       t.text :result
 
@@ -28,13 +31,13 @@ class CreateEffectiveQbOnline < ActiveRecord::Migration[6.0]
       t.timestamps
     end
 
-    add_index :qb_receipts, :order_id
+    add_index :qb_receipts, :order_id, if_not_exists: true
 
-    create_table :qb_receipt_items_name do |t|
+    create_table :qb_receipt_items, if_not_exists: true do |t|
       t.integer :qb_receipt_id
       t.integer :order_item_id
 
-      t.integer :item_id
+      t.string :item_id
 
       t.timestamps
     end

data/lib/effective_qb_online/version.rb

@@ -1,3 +1,3 @@
 module EffectiveQbOnline
-  VERSION = '0.7.0'.freeze
+  VERSION = '0.7.1'.freeze
 end

data/lib/effective_qb_online.rb

@@ -8,6 +8,7 @@ module EffectiveQbOnline
   def self.config_keys
     [
       :qb_realms_table_name, :qb_receipts_table_name, :qb_receipt_items_table_name,
+      :mailer, :parent_mailer, :deliver_method, :mailer_layout, :mailer_sender, :mailer_admin, :mailer_subject,
       :oauth_client_id, :oauth_client_secret,
       :layout
     ]
@@ -15,6 +16,10 @@ module EffectiveQbOnline
 
   include EffectiveGem
 
+  def self.mailer_class
+    mailer&.constantize || Effective::QbOnlineMailer
+  end
+
   def self.oauth2_client
     OAuth2::Client.new(
       oauth_client_id,

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: effective_qb_online
 version: !ruby/object:Gem::Version
-  version: 0.7.0
+  version: 0.7.1
 platform: ruby
 authors:
 - Code and Effect
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2025-04-17 00:00:00.000000000 Z
+date: 2025-05-22 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rails
@@ -216,6 +216,7 @@ files:
 - app/datatables/admin/effective_qb_receipts_datatable.rb
 - app/helpers/effective_qb_online_helper.rb
 - app/jobs/qb_sync_order_job.rb
+- app/mailers/effective/qb_online_mailer.rb
 - app/models/effective/qb_api.rb
 - app/models/effective/qb_realm.rb
 - app/models/effective/qb_receipt.rb
@@ -229,6 +230,7 @@ files:
 - app/views/admin/qb_receipts/_form.html.haml
 - app/views/admin/qb_receipts/edit.html.haml
 - app/views/admin/qb_receipts/new.html.haml
+- app/views/effective/qb_online_mailer/sync_error.html.haml
 - config/effective_qb_online.rb
 - config/routes.rb
 - db/migrate/101_create_effective_qb_online.rb