Compare commits
| Author | SHA1 | Date | |
|---|---|---|---|
|
|
e8d0189510 | ||
|
|
185eb99791 | ||
|
|
cc0b4ad584 | ||
|
|
595e86ff02 | ||
|
|
ccc70171b4 | ||
|
|
4229426621 | ||
|
|
e76bd12b7f |
No files matched your search
@@ -10,10 +10,10 @@ All the numbers can be changed in the settings.
|
|||||||
|
|
||||||
## What counts as a sale
|
## What counts as a sale
|
||||||
|
|
||||||
* **Invoices paid in full in the month.** An invoice is paid in full on the later of its own date and the date of the last payment or credit memo applied to it. A deposit taken months before the work counts in the month the job was invoiced and the last of it paid.
|
* **Invoices paid in full in the month.** An invoice is paid in full on the later of its own date and the date of the last payment or credit memo applied to it. A deposit taken months before the work counts in the month the job was invoiced and the last of it paid. These come from Redmine's own copy of the invoices: redmine_qbo keeps each invoice's sales tax and the day it was paid in full, up to date through QuickBooks' webhooks, so a month opens without reading its invoices from QuickBooks.
|
||||||
* **Sales receipts dated in the month** (counter sales paid on the spot). These can be turned off in the settings.
|
* **Sales receipts dated in the month** (counter sales paid on the spot). These can be turned off in the settings.
|
||||||
|
|
||||||
Amounts are without sales tax. Voided transactions ($0) don't count.
|
Amounts are without sales tax: the page shows each transaction's total, tax and the amount that counts. Voided transactions ($0) don't count.
|
||||||
|
|
||||||
## Deductions
|
## Deductions
|
||||||
|
|
||||||
@@ -24,16 +24,16 @@ Returns, canceled orders and refunded deposits are deducted from the month's sal
|
|||||||
|
|
||||||
## Approving a month
|
## Approving a month
|
||||||
|
|
||||||
**Sales commission** in the top menu opens this month, so far. It shows the month's sales, how far they are from the threshold, the pool, and each rep's payout. QuickBooks is read at most every 15 minutes; **Read from QuickBooks** reads it again now.
|
**Sales commission** in the top menu opens this month, so far. It shows the month's sales, how far they are from the threshold, the pool, and each rep's payout. The sales receipts, refund receipts and credit memos are read from QuickBooks, all three at once, and kept for 15 minutes. **Read from QuickBooks** brings everything up to date now: it syncs the invoices changed in QuickBooks since the last sync, and reads the receipts and credit memos again.
|
||||||
|
|
||||||
Once the month is over, **Approve for payroll** reads QuickBooks one last time. It records the sales, deductions, threshold, rates and payouts, so the month no longer changes with QuickBooks or the settings. **Payroll CSV** downloads each rep's payout. **Reopen** puts an approved month back to being worked out from QuickBooks; the unticked items, adjustments and notes are kept.
|
Once the month is over, **Approve for payroll** does the same one last time. It records the sales, deductions, threshold, rates and payouts, so the month no longer changes with QuickBooks or the settings. **Payroll CSV** downloads each rep's payout. **Reopen** puts an approved month back to being worked out from QuickBooks; the unticked items, adjustments and notes are kept.
|
||||||
|
|
||||||
Approvers see each invoice linked to its page in Redmine (or its PDF without the Write invoices permission), the sales receipts, refund receipts and credit memos linked to QuickBooks, and the list of months with the month picker.
|
Approvers see each invoice linked to its page in Redmine (or its PDF without the Write invoices permission), each sales receipt, refund receipt and credit memo linked to QuickBooks' PDF of it (opened through Redmine, without signing in to QuickBooks), and the list of months with the month picker.
|
||||||
|
|
||||||
## Requirements
|
## Requirements
|
||||||
|
|
||||||
* Redmine 7
|
* Redmine 7
|
||||||
* redmine_qbo 2026.11.0 or later, connected to QuickBooks Online
|
* redmine_qbo 2026.11.21 or later, connected to QuickBooks Online, with its webhook set up (so invoices and payments stay up to date)
|
||||||
|
|
||||||
## Installation
|
## Installation
|
||||||
|
|
||||||
@@ -50,6 +50,8 @@ Restart Redmine, then:
|
|||||||
2. **Administration » Plugins » Redmine QBO Commission plugin » Configure**: check the threshold, rates and what counts.
|
2. **Administration » Plugins » Redmine QBO Commission plugin » Configure**: check the threshold, rates and what counts.
|
||||||
3. **Administration » Roles and permissions**: give **Approve sales commission** to Management and Bookkeeping. Give **View sales commission** to the sales reps, so they can follow the month toward the threshold. Both are global permissions, so they apply to any role the user has in any project.
|
3. **Administration » Roles and permissions**: give **Approve sales commission** to Management and Bookkeeping. Give **View sales commission** to the sales reps, so they can follow the month toward the threshold. Both are global permissions, so they apply to any role the user has in any project.
|
||||||
|
|
||||||
|
After upgrading redmine_qbo to 2026.11.21, run a **Full sync** once (**Administration » Plugins » QuickBooks**), so invoices paid before the upgrade get the day they were paid in full. Until then, approvers see a warning on the month's page, and those invoices aren't counted.
|
||||||
|
|
||||||
**View sales commission** shows a month's sales, pool and payouts, read-only. It doesn't link to QuickBooks, list the months, change or approve a month, or download the payroll CSV.
|
**View sales commission** shows a month's sales, pool and payouts, read-only. It doesn't link to QuickBooks, list the months, change or approve a month, or download the payroll CSV.
|
||||||
|
|
||||||
## Tests
|
## Tests
|
||||||
|
|||||||
@@ -16,7 +16,7 @@ class SalesCommissionsController < ApplicationController
|
|||||||
menu_item :sales_commissions
|
menu_item :sales_commissions
|
||||||
|
|
||||||
before_action :authorize_global
|
before_action :authorize_global
|
||||||
before_action :find_month, except: [:index, :current]
|
before_action :find_month, except: [:index, :current, :txn_pdf]
|
||||||
before_action :find_open_record, only: [:update, :add_adjustment, :remove_adjustment]
|
before_action :find_open_record, only: [:update, :add_adjustment, :remove_adjustment]
|
||||||
|
|
||||||
helper :sales_commissions
|
helper :sales_commissions
|
||||||
@@ -45,6 +45,7 @@ class SalesCommissionsController < ApplicationController
|
|||||||
else
|
else
|
||||||
@report = RedmineQboCommission::MonthReport.new(@month, txns: read_transactions, commission_month: @record)
|
@report = RedmineQboCommission::MonthReport.new(@month, txns: read_transactions, commission_month: @record)
|
||||||
@read_at = RedmineQboCommission::QboSource.read_at(@month)
|
@read_at = RedmineQboCommission::QboSource.read_at(@month)
|
||||||
|
@missing_paid_on = RedmineQboCommission::QboSource.missing_paid_on? if @can_approve
|
||||||
end
|
end
|
||||||
|
|
||||||
respond_to do |format|
|
respond_to do |format|
|
||||||
@@ -120,6 +121,19 @@ class SalesCommissionsController < ApplicationController
|
|||||||
render_404
|
render_404
|
||||||
end
|
end
|
||||||
|
|
||||||
|
# QuickBooks' PDF of a sales receipt, refund receipt or credit memo, shown in the browser
|
||||||
|
def txn_pdf
|
||||||
|
pdf = RedmineQboCommission::Txn.pdf(params[:kind], params[:txn_id])
|
||||||
|
send_data pdf, type: 'application/pdf', disposition: 'inline',
|
||||||
|
filename: "#{params[:kind].to_s.dasherize}-#{params[:txn_id].to_i}.pdf"
|
||||||
|
rescue KeyError
|
||||||
|
render_404
|
||||||
|
rescue StandardError => e
|
||||||
|
Rails.logger.error "[redmine_qbo_commission] PDF of #{params[:kind]} #{params[:txn_id]}: #{e.message}"
|
||||||
|
flash[:error] = l(:error_sales_commission_qbo, error: e.message)
|
||||||
|
redirect_back_or_default sales_commissions_path
|
||||||
|
end
|
||||||
|
|
||||||
private
|
private
|
||||||
|
|
||||||
def find_month
|
def find_month
|
||||||
|
|||||||
@@ -17,8 +17,9 @@ module SalesCommissionsHelper
|
|||||||
RedmineQboCommission.format_rate(rate)
|
RedmineQboCommission.format_rate(rate)
|
||||||
end
|
end
|
||||||
|
|
||||||
# The transaction's number, linked for those who approve: an invoice opens in Redmine (its invoice page, or its
|
# The transaction's number, linked for those who approve: an invoice opens its page in Redmine (or its PDF
|
||||||
# PDF without the Write invoices permission); the others, which Redmine has no page for, open in QuickBooks
|
# without the Write invoices permission); a sales receipt, refund receipt or credit memo, which Redmine has no
|
||||||
|
# page for, opens QuickBooks' PDF of it
|
||||||
def commission_txn_link(txn, can_approve)
|
def commission_txn_link(txn, can_approve)
|
||||||
label = txn.doc_number.present? ? "##{txn.doc_number}" : txn.kind_name
|
label = txn.doc_number.present? ? "##{txn.doc_number}" : txn.kind_name
|
||||||
return label unless can_approve
|
return label unless can_approve
|
||||||
@@ -26,7 +27,7 @@ module SalesCommissionsHelper
|
|||||||
if txn.kind == 'invoice'
|
if txn.kind == 'invoice'
|
||||||
link_to(label, RedmineQboBilling.invoice_writer? ? edit_qbo_invoice_path(txn.txn_id) : invoice_path(txn.txn_id))
|
link_to(label, RedmineQboBilling.invoice_writer? ? edit_qbo_invoice_path(txn.txn_id) : invoice_path(txn.txn_id))
|
||||||
else
|
else
|
||||||
link_to(label, txn.qbo_url, target: '_blank', rel: 'noopener')
|
link_to(label, sales_commission_txn_pdf_path(txn.kind, txn.txn_id), target: '_blank', rel: 'noopener')
|
||||||
end
|
end
|
||||||
end
|
end
|
||||||
|
|
||||||
|
|||||||
@@ -38,6 +38,9 @@
|
|||||||
<% elsif !@month.completed? %>
|
<% elsif !@month.completed? %>
|
||||||
<p class="warning"><%= l(:text_sales_commission_month_in_progress, date: format_date(@month.end_date)) %></p>
|
<p class="warning"><%= l(:text_sales_commission_month_in_progress, date: format_date(@month.end_date)) %></p>
|
||||||
<% end %>
|
<% end %>
|
||||||
|
<% if !approved && @can_approve && @missing_paid_on %>
|
||||||
|
<p class="warning"><%= l(:text_sales_commission_missing_paid_on) %></p>
|
||||||
|
<% end %>
|
||||||
<% if !approved && @read_at %>
|
<% if !approved && @read_at %>
|
||||||
<p><em class="info"><%= l(:text_sales_commission_read_at, time: format_time(@read_at)) %></em></p>
|
<p><em class="info"><%= l(:text_sales_commission_read_at, time: format_time(@read_at)) %></em></p>
|
||||||
<% end %>
|
<% end %>
|
||||||
|
|||||||
@@ -7,7 +7,6 @@
|
|||||||
.sales-commission-progress span { display: block; height: 100%; background: #2e7d32; }
|
.sales-commission-progress span { display: block; height: 100%; background: #2e7d32; }
|
||||||
.sales-commission-ok { color: #2e7d32; }
|
.sales-commission-ok { color: #2e7d32; }
|
||||||
.sales-commission-miss { color: #b26a00; }
|
.sales-commission-miss { color: #b26a00; }
|
||||||
.sales-commission-error { color: #c62828; }
|
|
||||||
table.list.sales-commission-table td { text-align: right; }
|
table.list.sales-commission-table td { text-align: right; }
|
||||||
table.list.sales-commission-table td.name, table.list.sales-commission-table td.text { text-align: left; }
|
table.list.sales-commission-table td.name, table.list.sales-commission-table td.text { text-align: left; }
|
||||||
table.list.sales-commission-table td.check { text-align: center; }
|
table.list.sales-commission-table td.check { text-align: center; }
|
||||||
|
|||||||
@@ -66,7 +66,8 @@ en:
|
|||||||
error_sales_commission_qbo: "Couldn't read QuickBooks: %{error}"
|
error_sales_commission_qbo: "Couldn't read QuickBooks: %{error}"
|
||||||
|
|
||||||
text_sales_commission_month_in_progress: "This month isn't over until %{date}, so its sales can still change. It can be approved once it's over."
|
text_sales_commission_month_in_progress: "This month isn't over until %{date}, so its sales can still change. It can be approved once it's over."
|
||||||
text_sales_commission_read_at: "Read from QuickBooks at %{time}. It's read again every 15 minutes."
|
text_sales_commission_read_at: "Invoices are Redmine's copy of QuickBooks, kept up to date as they change. Sales receipts, refund receipts and credit memos were read from QuickBooks at %{time} (again every 15 minutes). Read from QuickBooks brings both up to date now."
|
||||||
|
text_sales_commission_missing_paid_on: "Some paid invoices were synced before Redmine kept the day they were paid in full, so they aren't counted yet. Run a full sync of invoices (Administration » Plugins » QuickBooks » Full sync) once."
|
||||||
text_sales_commission_approved_by: "Approved for payroll by %{user} on %{time}."
|
text_sales_commission_approved_by: "Approved for payroll by %{user} on %{time}."
|
||||||
text_sales_commission_threshold_met: "reached"
|
text_sales_commission_threshold_met: "reached"
|
||||||
text_sales_commission_threshold_of: "to reach %{amount}"
|
text_sales_commission_threshold_of: "to reach %{amount}"
|
||||||
|
|||||||
@@ -25,6 +25,10 @@ RedmineApp::Application.routes.draw do
|
|||||||
delete 'sales_commission/:month/adjustments/:id', to: 'sales_commissions#remove_adjustment',
|
delete 'sales_commission/:month/adjustments/:id', to: 'sales_commissions#remove_adjustment',
|
||||||
as: :sales_commission_adjustment, constraints: month
|
as: :sales_commission_adjustment, constraints: month
|
||||||
|
|
||||||
|
# QuickBooks' PDF of a sales receipt, refund receipt or credit memo (e.g. /sales_commission/pdf/credit_memo/123)
|
||||||
|
get 'sales_commission/pdf/:kind/:txn_id', to: 'sales_commissions#txn_pdf', as: :sales_commission_txn_pdf,
|
||||||
|
constraints: { kind: /sales_receipt|refund_receipt|credit_memo/, txn_id: /\d+/ }
|
||||||
|
|
||||||
# Administration » Commission reps
|
# Administration » Commission reps
|
||||||
resources :commission_reps, except: [:show]
|
resources :commission_reps, except: [:show]
|
||||||
|
|
||||||
|
|||||||
@@ -15,14 +15,14 @@ Redmine::Plugin.register :redmine_qbo_commission do
|
|||||||
author 'Rick Barrette'
|
author 'Rick Barrette'
|
||||||
description 'Monthly sales commission (SOP-OPS-013): totals the month\'s paid sales from QuickBooks Online, ' \
|
description 'Monthly sales commission (SOP-OPS-013): totals the month\'s paid sales from QuickBooks Online, ' \
|
||||||
'works out the commission pool, and records each sales rep\'s payout for payroll'
|
'works out the commission pool, and records each sales rep\'s payout for payroll'
|
||||||
version '2026.11.1'
|
version '2026.11.4'
|
||||||
url 'https://gitea.rickbarrette.org/ricky/redmine_qbo_commission'
|
url 'https://gitea.rickbarrette.org/ricky/redmine_qbo_commission'
|
||||||
author_url 'https://barrettefabrication.com'
|
author_url 'https://barrettefabrication.com'
|
||||||
requires_redmine version_or_higher: '7.0.0'
|
requires_redmine version_or_higher: '7.0.0'
|
||||||
|
|
||||||
# The QuickBooks connection lives in redmine_qbo
|
# The QuickBooks connection lives in redmine_qbo
|
||||||
begin
|
begin
|
||||||
requires_redmine_plugin :redmine_qbo, version_or_higher: '2026.11.0'
|
requires_redmine_plugin :redmine_qbo, version_or_higher: '2026.11.21'
|
||||||
rescue Redmine::PluginNotFound
|
rescue Redmine::PluginNotFound
|
||||||
raise 'Please install the redmine_qbo plugin (https://github.com/rickbarrette/redmine_qbo)'
|
raise 'Please install the redmine_qbo plugin (https://github.com/rickbarrette/redmine_qbo)'
|
||||||
end
|
end
|
||||||
@@ -34,7 +34,7 @@ Redmine::Plugin.register :redmine_qbo_commission do
|
|||||||
# The months, adjusting and approving a month for payroll, reopening it, the payroll CSV
|
# The months, adjusting and approving a month for payroll, reopening it, the payroll CSV
|
||||||
permission :approve_sales_commission,
|
permission :approve_sales_commission,
|
||||||
{ sales_commissions: [:index, :current, :show, :update, :refresh, :reopen,
|
{ sales_commissions: [:index, :current, :show, :update, :refresh, :reopen,
|
||||||
:add_adjustment, :remove_adjustment] },
|
:add_adjustment, :remove_adjustment, :txn_pdf] },
|
||||||
global: true
|
global: true
|
||||||
|
|
||||||
menu :top_menu, :sales_commissions, { controller: 'sales_commissions', action: 'current' },
|
menu :top_menu, :sales_commissions, { controller: 'sales_commissions', action: 'current' },
|
||||||
|
|||||||
@@ -9,44 +9,53 @@
|
|||||||
#THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
|
#THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
|
||||||
|
|
||||||
module RedmineQboCommission
|
module RedmineQboCommission
|
||||||
# Reads a month's paid sales and deductions from QuickBooks Online (SOP-OPS-013 §4):
|
# A month's paid sales and deductions (SOP-OPS-013 §4):
|
||||||
#
|
#
|
||||||
# * Invoices paid in full that month. An invoice is paid in full on the later of its own date and the date of
|
# * Invoices paid in full that month, from Redmine's own copy of the invoices (redmine_qbo keeps each invoice's
|
||||||
# the last payment or credit memo applied to it, so a deposit taken months before the work counts in the
|
# sales tax and the day it was paid in full: the later of its date and the date of the last payment or credit
|
||||||
# month it was invoiced and the last of it paid. QuickBooks updates an invoice when a payment is applied to
|
# memo applied to it, so a deposit taken before the work counts in the month the job was invoiced).
|
||||||
# it, so the invoices with a $0 balance changed since the month began are all that need reading.
|
# * Sales receipts dated in the month (counter sales paid on the spot), if the settings say so, read from
|
||||||
# * Sales receipts dated in the month (counter sales paid on the spot), if the settings say so.
|
# QuickBooks.
|
||||||
# * Refund receipts and credit memos dated in the month, as deductions, if the settings say so. Credit memos
|
# * Refund receipts and credit memos dated in the month, as deductions, if the settings say so, read from
|
||||||
# made only of the excluded products/services (e.g. tech bonus credits) aren't returns and are left out.
|
# QuickBooks. Credit memos made only of the excluded products/services (e.g. tech bonus credits) aren't
|
||||||
|
# returns and are left out.
|
||||||
#
|
#
|
||||||
# Voided transactions (a $0 total) don't count. Amounts are kept without sales tax.
|
# What's read from QuickBooks is kept for CACHE_TTL; the three reads run at the same time. Voided transactions
|
||||||
|
# (a $0 total) don't count. Amounts are kept without sales tax.
|
||||||
class QboSource
|
class QboSource
|
||||||
CACHE_TTL = 15.minutes
|
CACHE_TTL = 15.minutes
|
||||||
BATCH = 1000
|
BATCH = 1000
|
||||||
IDS_PER_QUERY = 100
|
|
||||||
|
|
||||||
# The month's transactions, read from QuickBooks at most every CACHE_TTL (refresh: true reads them now)
|
# The month's transactions. refresh: true first brings Redmine's invoices up to date with QuickBooks (only
|
||||||
|
# those changed since the last sync), and reads the receipts and credit memos again now.
|
||||||
def self.transactions(month, refresh: false)
|
def self.transactions(month, refresh: false)
|
||||||
Rails.cache.delete(cache_key(month)) if refresh
|
if refresh
|
||||||
cached = Rails.cache.fetch(cache_key(month), expires_in: CACHE_TTL) do
|
sync_invoices
|
||||||
{ 'read_at' => Time.current.iso8601, 'txns' => new(month).fetch.map(&:to_cache) }
|
Rails.cache.delete(cache_key(month))
|
||||||
end
|
end
|
||||||
cached['txns'].map { |hash| Txn.from_h(hash) }
|
cached = Rails.cache.fetch(cache_key(month), expires_in: CACHE_TTL) do
|
||||||
|
{ 'read_at' => Time.current.iso8601, 'txns' => new(month).receipts.map(&:to_cache) }
|
||||||
|
end
|
||||||
|
(new(month).invoices + cached['txns'].map { |hash| Txn.from_h(hash) }).sort_by { |txn| [txn.txn_date, txn.doc_number.to_s] }
|
||||||
end
|
end
|
||||||
|
|
||||||
# When the cached transactions were read from QuickBooks, or nil when they aren't cached
|
# When the receipts and credit memos were read from QuickBooks, or nil when they aren't cached
|
||||||
def self.read_at(month)
|
def self.read_at(month)
|
||||||
value = Rails.cache.read(cache_key(month))
|
value = Rails.cache.read(cache_key(month))
|
||||||
value && Time.zone.parse(value['read_at'].to_s)
|
value && Time.zone.parse(value['read_at'].to_s)
|
||||||
end
|
end
|
||||||
|
|
||||||
def self.cache_key(month)
|
def self.cache_key(month)
|
||||||
"redmine_qbo_commission/txns/#{month.to_param}"
|
"redmine_qbo_commission/receipts/#{month.to_param}"
|
||||||
end
|
end
|
||||||
|
|
||||||
# The day an invoice was paid in full: the later of its date and the dates of what was applied to it
|
# Paid invoices synced before redmine_qbo kept the day they were paid in full (a full invoice sync fills it in)
|
||||||
def self.paid_on(txn_date, applied_dates)
|
def self.missing_paid_on?
|
||||||
[txn_date, *applied_dates.compact].compact.max
|
Invoice.where(balance: 0, paid_on: nil).where('total_amount > 0').exists?
|
||||||
|
end
|
||||||
|
|
||||||
|
def self.sync_invoices
|
||||||
|
InvoiceSyncService.new.sync
|
||||||
end
|
end
|
||||||
|
|
||||||
attr_reader :month
|
attr_reader :month
|
||||||
@@ -55,81 +64,62 @@ module RedmineQboCommission
|
|||||||
@month = month
|
@month = month
|
||||||
end
|
end
|
||||||
|
|
||||||
def fetch
|
# Invoices paid in full in the month, from Redmine's invoices
|
||||||
txns = invoices
|
def invoices
|
||||||
txns += dated(Quickbooks::Service::SalesReceipt, 'SalesReceipt', 'sales_receipt') if Settings.include_sales_receipts?
|
Invoice.where(paid_on: month.range).where('total_amount > 0').includes(:customer).map do |invoice|
|
||||||
txns += dated(Quickbooks::Service::RefundReceipt, 'RefundReceipt', 'refund_receipt') if Settings.deduct_refund_receipts?
|
Txn.new(kind: 'invoice', txn_id: invoice.id.to_s, doc_number: invoice.doc_number.to_s,
|
||||||
txns += credit_memos if Settings.deduct_credit_memos?
|
customer_name: invoice.customer&.name.to_s, txn_date: invoice.paid_on,
|
||||||
txns.sort_by { |txn| [txn.txn_date, txn.doc_number.to_s] }
|
total: invoice.total_amount.to_d, tax: invoice.tax_amount.to_d)
|
||||||
|
end
|
||||||
|
end
|
||||||
|
|
||||||
|
# Sales receipts, refund receipts and credit memos dated in the month, read from QuickBooks together
|
||||||
|
def receipts
|
||||||
|
reads = []
|
||||||
|
reads << ['SalesReceipt', 'sales_receipt'] if Settings.include_sales_receipts?
|
||||||
|
reads << ['RefundReceipt', 'refund_receipt'] if Settings.deduct_refund_receipts?
|
||||||
|
reads << ['CreditMemo', 'credit_memo'] if Settings.deduct_credit_memos?
|
||||||
|
return [] if reads.empty?
|
||||||
|
|
||||||
|
excluded = Settings.excluded_item_ids
|
||||||
|
services = reads.to_h { |entity, _| [entity, "Quickbooks::Service::#{entity}".constantize] }
|
||||||
|
qbo = QboConnectionService.current!
|
||||||
|
# The threads only call QuickBooks; everything else is done here, after they're joined
|
||||||
|
records = qbo.perform_authenticated_request do |access_token|
|
||||||
|
threads = reads.map do |entity, _|
|
||||||
|
service = services[entity].new(company_id: qbo.realm_id, access_token: access_token)
|
||||||
|
sql = "SELECT * FROM #{entity} WHERE TxnDate >= '#{month.start_date.iso8601}' AND TxnDate <= '#{month.end_date.iso8601}'"
|
||||||
|
Thread.new { query(service, sql) }
|
||||||
|
end
|
||||||
|
reads.map(&:last).zip(threads.map(&:value))
|
||||||
|
end
|
||||||
|
records.flat_map do |kind, list|
|
||||||
|
list.filter_map do |record|
|
||||||
|
next unless record.total.to_d.positive?
|
||||||
|
next if kind == 'credit_memo' && !return?(record, excluded)
|
||||||
|
|
||||||
|
txn(kind, record)
|
||||||
|
end
|
||||||
|
end
|
||||||
end
|
end
|
||||||
|
|
||||||
private
|
private
|
||||||
|
|
||||||
def invoices
|
# A credit memo is a return unless it's made only of the excluded products/services
|
||||||
since = month.start_date.in_time_zone.iso8601
|
def return?(memo, excluded)
|
||||||
remote = query(Quickbooks::Service::Invoice,
|
items = Array(memo.line_items).filter_map { |line| line.sales_item_line_detail&.item_ref&.value&.to_s }
|
||||||
"SELECT * FROM Invoice WHERE Balance = '0' AND MetaData.LastUpdatedTime >= '#{since}'")
|
excluded.empty? || items.empty? || !items.all? { |item| excluded.include?(item) }
|
||||||
remote = remote.select { |invoice| invoice.total.to_d.positive? && invoice.txn_date && invoice.txn_date <= month.end_date }
|
|
||||||
dates = applied_dates(remote)
|
|
||||||
remote.filter_map do |invoice|
|
|
||||||
applied = linked(invoice).map { |link| dates[[link.txn_type, link.txn_id.to_s]] }
|
|
||||||
paid_on = self.class.paid_on(invoice.txn_date, applied)
|
|
||||||
txn('invoice', invoice, paid_on) if month.range.cover?(paid_on)
|
|
||||||
end
|
|
||||||
end
|
end
|
||||||
|
|
||||||
def credit_memos
|
def txn(kind, record)
|
||||||
excluded = Settings.excluded_item_ids
|
|
||||||
dated(Quickbooks::Service::CreditMemo, 'CreditMemo', 'credit_memo') do |memo|
|
|
||||||
items = Array(memo.line_items).filter_map { |line| line.sales_item_line_detail&.item_ref&.value&.to_s }
|
|
||||||
excluded.empty? || items.empty? || !items.all? { |item| excluded.include?(item) }
|
|
||||||
end
|
|
||||||
end
|
|
||||||
|
|
||||||
# The transactions of a type dated in the month (that the block keeps)
|
|
||||||
def dated(service_class, entity, kind)
|
|
||||||
remote = query(service_class, "SELECT * FROM #{entity} WHERE TxnDate >= '#{month.start_date.iso8601}' " \
|
|
||||||
"AND TxnDate <= '#{month.end_date.iso8601}'")
|
|
||||||
remote.filter_map do |record|
|
|
||||||
next unless record.total.to_d.positive?
|
|
||||||
next if block_given? && !yield(record)
|
|
||||||
|
|
||||||
txn(kind, record, record.txn_date)
|
|
||||||
end
|
|
||||||
end
|
|
||||||
|
|
||||||
# { ["Payment", "123"] => Date } for the payments and credit memos applied to the invoices
|
|
||||||
def applied_dates(invoices)
|
|
||||||
ids = Hash.new { |hash, type| hash[type] = [] }
|
|
||||||
invoices.each { |invoice| linked(invoice).each { |link| ids[link.txn_type] << link.txn_id.to_s } }
|
|
||||||
{ 'Payment' => Quickbooks::Service::Payment, 'CreditMemo' => Quickbooks::Service::CreditMemo }
|
|
||||||
.each_with_object({}) do |(type, service_class), dates|
|
|
||||||
ids[type].uniq.each_slice(IDS_PER_QUERY) do |slice|
|
|
||||||
list = slice.map { |id| "'#{id.gsub(/\D/, '')}'" }.join(',')
|
|
||||||
query(service_class, "SELECT * FROM #{type} WHERE Id IN (#{list})").each do |record|
|
|
||||||
dates[[type, record.id.to_s]] = record.txn_date
|
|
||||||
end
|
|
||||||
end
|
|
||||||
end
|
|
||||||
end
|
|
||||||
|
|
||||||
def linked(invoice)
|
|
||||||
Array(invoice.linked_transactions).select { |link| %w[Payment CreditMemo].include?(link.txn_type) }
|
|
||||||
end
|
|
||||||
|
|
||||||
def txn(kind, record, date)
|
|
||||||
Txn.new(kind: kind, txn_id: record.id.to_s, doc_number: record.doc_number.to_s,
|
Txn.new(kind: kind, txn_id: record.id.to_s, doc_number: record.doc_number.to_s,
|
||||||
customer_name: record.customer_ref&.name.to_s, txn_date: date,
|
customer_name: record.customer_ref&.name.to_s, txn_date: record.txn_date,
|
||||||
total: record.total.to_d, tax: record.txn_tax_detail&.total_tax.to_d)
|
total: record.total.to_d, tax: record.txn_tax_detail&.total_tax.to_d)
|
||||||
end
|
end
|
||||||
|
|
||||||
def query(service_class, sql)
|
def query(service, sql)
|
||||||
results = []
|
results = []
|
||||||
qbo = QboConnectionService.current!
|
service.query_in_batches(sql, per_page: BATCH) { |batch| results.concat(Array(batch)) }
|
||||||
qbo.perform_authenticated_request do |access_token|
|
|
||||||
service = service_class.new(company_id: qbo.realm_id, access_token: access_token)
|
|
||||||
service.query_in_batches(sql, per_page: BATCH) { |batch| results.concat(Array(batch)) }
|
|
||||||
end
|
|
||||||
results
|
results
|
||||||
end
|
end
|
||||||
end
|
end
|
||||||
|
|||||||
@@ -50,12 +50,18 @@ module RedmineQboCommission
|
|||||||
I18n.t("label_sales_commission_kind_#{kind}")
|
I18n.t("label_sales_commission_kind_#{kind}")
|
||||||
end
|
end
|
||||||
|
|
||||||
# The transaction's page in QuickBooks
|
# The QuickBooks services that print the transactions Redmine has no page for
|
||||||
def qbo_url
|
PDF_SERVICES = { 'sales_receipt' => 'SalesReceipt', 'refund_receipt' => 'RefundReceipt',
|
||||||
host = defined?(RedmineQbo) && RedmineQbo.respond_to?(:sandbox_mode?) && RedmineQbo.sandbox_mode? ? 'sandbox' : 'app'
|
'credit_memo' => 'CreditMemo' }.freeze
|
||||||
page = { 'invoice' => 'invoice', 'sales_receipt' => 'salesreceipt', 'refund_receipt' => 'refundreceipt',
|
|
||||||
'credit_memo' => 'creditmemo' }[kind]
|
# QuickBooks' PDF of a sales receipt, refund receipt or credit memo (an invoice opens in Redmine instead)
|
||||||
"https://#{host}.qbo.intuit.com/app/#{page}?txnId=#{txn_id}"
|
def self.pdf(kind, txn_id)
|
||||||
|
entity = PDF_SERVICES.fetch(kind.to_s)
|
||||||
|
qbo = QboConnectionService.current!
|
||||||
|
qbo.perform_authenticated_request do |access_token|
|
||||||
|
service = "Quickbooks::Service::#{entity}".constantize.new(company_id: qbo.realm_id, access_token: access_token)
|
||||||
|
service.pdf(Struct.new(:id).new(txn_id.to_s))
|
||||||
|
end
|
||||||
end
|
end
|
||||||
end
|
end
|
||||||
end
|
end
|
||||||
@@ -57,10 +57,10 @@ class SalesCommissionsTest < Redmine::IntegrationTest
|
|||||||
assert_select 'input[name=?][value=?][checked]', 'included[]', 'refund_receipt:3'
|
assert_select 'input[name=?][value=?][checked]', 'included[]', 'refund_receipt:3'
|
||||||
assert_select 'input[name=?][value="2"][checked]', 'eligible[]'
|
assert_select 'input[name=?][value="2"][checked]', 'eligible[]'
|
||||||
assert_select 'input[name=approve]'
|
assert_select 'input[name=approve]'
|
||||||
# Invoices open in Redmine, the refund receipt (no Redmine page) in QuickBooks
|
# Invoices open in Redmine, the refund receipt (no Redmine page) as QuickBooks' PDF through Redmine
|
||||||
assert_select '#sales-commission-sales a[href=?]', '/qbo_invoices/1/edit'
|
assert_select '#sales-commission-sales a[href=?]', '/qbo_invoices/1/edit'
|
||||||
assert_select '#sales-commission-sales a[href*="qbo.intuit.com"]', count: 0
|
assert_select '#sales-commission-deductions a[href=?]', '/sales_commission/pdf/refund_receipt/3'
|
||||||
assert_select '#sales-commission-deductions a[href*="qbo.intuit.com/app/refundreceipt?txnId=3"]'
|
assert_select 'a[href*="qbo.intuit.com"]', count: 0
|
||||||
end
|
end
|
||||||
|
|
||||||
def test_view_only
|
def test_view_only
|
||||||
@@ -181,4 +181,22 @@ class SalesCommissionsTest < Redmine::IntegrationTest
|
|||||||
post '/sales_commission/2026-10/refresh'
|
post '/sales_commission/2026-10/refresh'
|
||||||
assert_redirected_to '/sales_commission/2026-10'
|
assert_redirected_to '/sales_commission/2026-10'
|
||||||
end
|
end
|
||||||
|
|
||||||
|
def test_txn_pdf
|
||||||
|
RedmineQboCommission::Txn.expects(:pdf).with('credit_memo', '123').returns('%PDF-1.4 credit memo')
|
||||||
|
log_user('admin', 'admin')
|
||||||
|
get '/sales_commission/pdf/credit_memo/123'
|
||||||
|
assert_response :success
|
||||||
|
assert_equal 'application/pdf', response.media_type
|
||||||
|
assert_equal '%PDF-1.4 credit memo', response.body
|
||||||
|
get '/sales_commission/pdf/invoice/123'
|
||||||
|
assert_response :not_found
|
||||||
|
end
|
||||||
|
|
||||||
|
def test_txn_pdf_needs_approve
|
||||||
|
Role.find(1).add_permission!(:view_sales_commission)
|
||||||
|
log_user('jsmith', 'jsmith')
|
||||||
|
get '/sales_commission/pdf/sales_receipt/5'
|
||||||
|
assert_response :forbidden
|
||||||
|
end
|
||||||
end
|
end
|
||||||
@@ -13,42 +13,66 @@ require File.expand_path('../test_helper', __dir__)
|
|||||||
class QboSourceTest < ActiveSupport::TestCase
|
class QboSourceTest < ActiveSupport::TestCase
|
||||||
include QboCommissionTestHelper
|
include QboCommissionTestHelper
|
||||||
|
|
||||||
|
Source = RedmineQboCommission::QboSource
|
||||||
|
|
||||||
|
# Stands in for the QuickBooks connection: runs the block with a token
|
||||||
|
class FakeQbo
|
||||||
|
def realm_id
|
||||||
|
'123'
|
||||||
|
end
|
||||||
|
|
||||||
|
def perform_authenticated_request
|
||||||
|
yield OAuth2::AccessToken.new(OAuth2::Client.new('id', 'secret'), 'token')
|
||||||
|
end
|
||||||
|
end
|
||||||
|
|
||||||
|
def setup
|
||||||
|
Invoice.where(id: 9001..9099).delete_all
|
||||||
|
Customer.where(id: 9500).delete_all
|
||||||
|
customer = Customer.new(id: 9500, name: 'Jane Customer')
|
||||||
|
customer.skip_qbo_push = true
|
||||||
|
customer.save!
|
||||||
|
QboConnectionService.stubs(:current!).returns(FakeQbo.new)
|
||||||
|
end
|
||||||
|
|
||||||
|
def local_invoice(id, total, paid_on:, tax: 0, balance: 0)
|
||||||
|
invoice = Invoice.new(id: id, doc_number: "10#{id}", txn_date: MONTH_START, customer_id: 9500,
|
||||||
|
total_amount: total, tax_amount: tax, balance: balance, paid_on: paid_on)
|
||||||
|
invoice.skip_qbo_push = true
|
||||||
|
invoice.save!
|
||||||
|
end
|
||||||
|
|
||||||
# Answers the source's QuickBooks queries from lists of records, by the entity queried
|
# Answers the source's QuickBooks queries from lists of records, by the entity queried
|
||||||
class FakeSource < RedmineQboCommission::QboSource
|
class FakeSource < RedmineQboCommission::QboSource
|
||||||
attr_reader :queries
|
def initialize(month, records, queries)
|
||||||
|
|
||||||
def initialize(month, records)
|
|
||||||
super(month)
|
super(month)
|
||||||
@records = records
|
@records = records
|
||||||
@queries = []
|
@queries = queries
|
||||||
end
|
end
|
||||||
|
|
||||||
private
|
private
|
||||||
|
|
||||||
def query(_service_class, sql)
|
def query(_service, sql)
|
||||||
@queries << sql
|
@queries << sql
|
||||||
entity = sql[/FROM (\w+)/, 1]
|
@records.fetch(sql[/FROM (\w+)/, 1], [])
|
||||||
list = @records.fetch(entity, [])
|
|
||||||
ids = sql[/Id IN \(([^)]*)\)/, 1]
|
|
||||||
ids ? list.select { |record| ids.include?("'#{record.id}'") } : list
|
|
||||||
end
|
end
|
||||||
end
|
end
|
||||||
|
|
||||||
def ref(name)
|
# Every QboSource made from now on answers from the records (QboSource.transactions makes its own)
|
||||||
Quickbooks::Model::BaseReference.new(name)
|
def stub_queries(records)
|
||||||
|
@queries = []
|
||||||
|
queries = @queries
|
||||||
|
Source.define_singleton_method(:new) { |month| FakeSource.allocate.tap { |f| f.send(:initialize, month, records, queries) } }
|
||||||
end
|
end
|
||||||
|
|
||||||
def link(type, id)
|
def teardown
|
||||||
linked = Quickbooks::Model::LinkedTransaction.new
|
Source.singleton_class.send(:remove_method, :new) if Source.singleton_methods(false).include?(:new)
|
||||||
linked.txn_type = type
|
|
||||||
linked.txn_id = id.to_s
|
|
||||||
linked
|
|
||||||
end
|
end
|
||||||
|
|
||||||
def record(klass, id, total, date, tax: nil, links: [], items: [])
|
def record(klass, id, total, date, tax: nil, items: [])
|
||||||
record = klass.new
|
record = klass.new
|
||||||
record.id = id.to_s
|
record.id = id.to_s
|
||||||
record.doc_number = "D#{id}" if record.respond_to?(:doc_number=)
|
record.doc_number = "D#{id}"
|
||||||
record.txn_date = date
|
record.txn_date = date
|
||||||
record.total = BigDecimal(total.to_s)
|
record.total = BigDecimal(total.to_s)
|
||||||
record.customer_ref = Quickbooks::Model::BaseReference.new(id.to_s).tap { |r| r.name = "Customer #{id}" }
|
record.customer_ref = Quickbooks::Model::BaseReference.new(id.to_s).tap { |r| r.name = "Customer #{id}" }
|
||||||
@@ -56,7 +80,6 @@ class QboSourceTest < ActiveSupport::TestCase
|
|||||||
record.txn_tax_detail = Quickbooks::Model::TransactionTaxDetail.new
|
record.txn_tax_detail = Quickbooks::Model::TransactionTaxDetail.new
|
||||||
record.txn_tax_detail.total_tax = BigDecimal(tax.to_s)
|
record.txn_tax_detail.total_tax = BigDecimal(tax.to_s)
|
||||||
end
|
end
|
||||||
record.linked_transactions = links if record.respond_to?(:linked_transactions=)
|
|
||||||
if items.any?
|
if items.any?
|
||||||
record.line_items = items.map do |item_id|
|
record.line_items = items.map do |item_id|
|
||||||
line = Quickbooks::Model::Line.new
|
line = Quickbooks::Model::Line.new
|
||||||
@@ -68,84 +91,65 @@ class QboSourceTest < ActiveSupport::TestCase
|
|||||||
record
|
record
|
||||||
end
|
end
|
||||||
|
|
||||||
def payment(id, date)
|
def test_invoices_paid_in_full_in_the_month_come_from_redmine
|
||||||
record(Quickbooks::Model::Payment, id, 1, date)
|
local_invoice(9001, 1070, tax: 70, paid_on: MONTH_START + 9)
|
||||||
end
|
local_invoice(9002, 500, paid_on: MONTH_START + 1)
|
||||||
|
local_invoice(9003, 800, paid_on: Date.new(2026, 11, 2)) # paid in November
|
||||||
def invoice(id, total, date, **options)
|
local_invoice(9004, 300, paid_on: nil, balance: 300) # open
|
||||||
record(Quickbooks::Model::Invoice, id, total, date, **options)
|
local_invoice(9005, 0, paid_on: MONTH_START + 3) # voided
|
||||||
end
|
txns = Source.new(commission_month).invoices.sort_by(&:txn_id)
|
||||||
|
assert_equal %w[9001 9002], txns.map(&:txn_id)
|
||||||
def test_paid_on
|
assert_equal BigDecimal('1000'), txns.first.net
|
||||||
assert_equal Date.new(2026, 10, 9), RedmineQboCommission::QboSource.paid_on(Date.new(2026, 10, 2), [Date.new(2026, 10, 9), nil])
|
assert_equal MONTH_START + 9, txns.first.txn_date
|
||||||
# A deposit taken before the invoice: paid in full on the invoice's date
|
assert_equal 'Jane Customer', txns.first.customer_name
|
||||||
assert_equal Date.new(2026, 10, 2), RedmineQboCommission::QboSource.paid_on(Date.new(2026, 10, 2), [Date.new(2026, 8, 1)])
|
|
||||||
end
|
|
||||||
|
|
||||||
def test_invoices_count_in_the_month_paid_in_full
|
|
||||||
records = {
|
|
||||||
'Invoice' => [
|
|
||||||
invoice(1, 1070, MONTH_START + 4, tax: 70, links: [link('Payment', 50)]), # paid in October
|
|
||||||
invoice(2, 500, Date.new(2026, 9, 20), links: [link('Payment', 51)]), # September, paid in October
|
|
||||||
invoice(3, 800, MONTH_START + 2, links: [link('Payment', 52)]), # paid in November
|
|
||||||
invoice(4, 300, MONTH_START + 6, links: [link('Payment', 53), link('Estimate', 9)]), # deposit from August
|
|
||||||
invoice(5, 0, MONTH_START + 6), # voided
|
|
||||||
invoice(6, 200, Date.new(2026, 11, 3), links: [link('Payment', 50)]), # dated November
|
|
||||||
invoice(7, 100, Date.new(2026, 9, 3), links: [link('CreditMemo', 70)]) # settled by a September credit memo
|
|
||||||
],
|
|
||||||
'Payment' => [payment(50, MONTH_START + 9), payment(51, MONTH_START + 1), payment(52, Date.new(2026, 11, 2)),
|
|
||||||
payment(53, Date.new(2026, 8, 1))],
|
|
||||||
'CreditMemo' => [record(Quickbooks::Model::CreditMemo, 70, 100, Date.new(2026, 9, 30))]
|
|
||||||
}
|
|
||||||
with_commission_settings('include_sales_receipts' => '0', 'deduct_refund_receipts' => '0', 'deduct_credit_memos' => '0') do
|
|
||||||
source = FakeSource.new(commission_month, records)
|
|
||||||
txns = source.fetch
|
|
||||||
assert_equal %w[2 4 1], txns.map(&:txn_id)
|
|
||||||
first = txns.find { |txn| txn.txn_id == '1' }
|
|
||||||
assert_equal MONTH_START + 9, first.txn_date
|
|
||||||
assert_equal BigDecimal('1000'), first.net
|
|
||||||
assert_equal 'Customer 1', first.customer_name
|
|
||||||
assert_equal MONTH_START + 6, txns.find { |txn| txn.txn_id == '4' }.txn_date
|
|
||||||
assert_match(/Balance = '0' AND MetaData.LastUpdatedTime >= '2026-10-01T00:00:00/, source.queries.first)
|
|
||||||
end
|
|
||||||
end
|
end
|
||||||
|
|
||||||
def test_receipts_and_credit_memos
|
def test_receipts_and_credit_memos
|
||||||
records = {
|
stub_queries(
|
||||||
'SalesReceipt' => [record(Quickbooks::Model::SalesReceipt, 1, 107, MONTH_START + 3, tax: 7)],
|
'SalesReceipt' => [record(Quickbooks::Model::SalesReceipt, 1, 107, MONTH_START + 3, tax: 7)],
|
||||||
'RefundReceipt' => [record(Quickbooks::Model::RefundReceipt, 2, 50, MONTH_START + 4)],
|
'RefundReceipt' => [record(Quickbooks::Model::RefundReceipt, 2, 50, MONTH_START + 4)],
|
||||||
'CreditMemo' => [record(Quickbooks::Model::CreditMemo, 3, 40, MONTH_START + 5, items: [12]),
|
'CreditMemo' => [record(Quickbooks::Model::CreditMemo, 3, 40, MONTH_START + 5, items: [12]),
|
||||||
record(Quickbooks::Model::CreditMemo, 4, 100, MONTH_START + 5, items: [31]), # tech bonus
|
record(Quickbooks::Model::CreditMemo, 4, 100, MONTH_START + 5, items: [31]), # tech bonus
|
||||||
record(Quickbooks::Model::CreditMemo, 5, 60, MONTH_START + 5, items: [31, 12])]
|
record(Quickbooks::Model::CreditMemo, 5, 60, MONTH_START + 5, items: [31, 12])]
|
||||||
}
|
)
|
||||||
with_commission_settings('excluded_item_ids' => ['31']) do
|
with_commission_settings('excluded_item_ids' => ['31']) do
|
||||||
source = FakeSource.new(commission_month, records)
|
txns = Source.new(commission_month).receipts
|
||||||
txns = source.fetch
|
|
||||||
assert_equal [%w[sales_receipt 1], %w[refund_receipt 2], %w[credit_memo 3], %w[credit_memo 5]],
|
assert_equal [%w[sales_receipt 1], %w[refund_receipt 2], %w[credit_memo 3], %w[credit_memo 5]],
|
||||||
txns.map { |txn| [txn.kind, txn.txn_id] }
|
txns.map { |txn| [txn.kind, txn.txn_id] }
|
||||||
assert_equal BigDecimal('100'), txns.first.net
|
assert_equal BigDecimal('100'), txns.first.net
|
||||||
assert(source.queries.any? { |sql| sql.include?("TxnDate >= '2026-10-01' AND TxnDate <= '2026-10-31'") })
|
assert @queries.all? { |sql| sql.include?("TxnDate >= '2026-10-01' AND TxnDate <= '2026-10-31'") }
|
||||||
|
assert_equal 3, @queries.size
|
||||||
end
|
end
|
||||||
end
|
end
|
||||||
|
|
||||||
def test_settings_leave_out_receipts_and_credit_memos
|
def test_settings_leave_out_receipts_and_credit_memos
|
||||||
records = { 'SalesReceipt' => [record(Quickbooks::Model::SalesReceipt, 1, 100, MONTH_START)],
|
stub_queries({})
|
||||||
'RefundReceipt' => [record(Quickbooks::Model::RefundReceipt, 2, 50, MONTH_START)],
|
|
||||||
'CreditMemo' => [record(Quickbooks::Model::CreditMemo, 3, 40, MONTH_START)] }
|
|
||||||
with_commission_settings('include_sales_receipts' => '0', 'deduct_refund_receipts' => '0', 'deduct_credit_memos' => '0') do
|
with_commission_settings('include_sales_receipts' => '0', 'deduct_refund_receipts' => '0', 'deduct_credit_memos' => '0') do
|
||||||
assert_equal [], FakeSource.new(commission_month, records).fetch
|
assert_equal [], Source.new(commission_month).receipts
|
||||||
|
assert_empty @queries
|
||||||
end
|
end
|
||||||
end
|
end
|
||||||
|
|
||||||
def test_transactions_are_cached
|
def test_transactions_and_refresh
|
||||||
source = FakeSource.new(commission_month, { 'SalesReceipt' => [record(Quickbooks::Model::SalesReceipt, 1, 100, MONTH_START)] })
|
local_invoice(9001, 200, paid_on: MONTH_START + 2)
|
||||||
RedmineQboCommission::QboSource.expects(:new).once.returns(source)
|
stub_queries('RefundReceipt' => [record(Quickbooks::Model::RefundReceipt, 2, 50, MONTH_START + 4)])
|
||||||
|
Source.expects(:sync_invoices).once
|
||||||
with_memory_cache do
|
with_memory_cache do
|
||||||
2.times { assert_equal [BigDecimal('100')], RedmineQboCommission::QboSource.transactions(commission_month).map(&:net) }
|
2.times { assert_equal %w[invoice refund_receipt], Source.transactions(commission_month).map(&:kind) }
|
||||||
assert RedmineQboCommission::QboSource.read_at(commission_month)
|
assert_equal 3, @queries.size # read once, then cached
|
||||||
|
assert Source.read_at(commission_month)
|
||||||
|
Source.transactions(commission_month, refresh: true)
|
||||||
|
assert_equal 6, @queries.size
|
||||||
end
|
end
|
||||||
end
|
end
|
||||||
|
|
||||||
|
def test_missing_paid_on
|
||||||
|
local_invoice(9001, 200, paid_on: MONTH_START)
|
||||||
|
assert_not Source.missing_paid_on?
|
||||||
|
local_invoice(9002, 200, paid_on: nil)
|
||||||
|
assert Source.missing_paid_on?
|
||||||
|
end
|
||||||
|
|
||||||
private
|
private
|
||||||
|
|
||||||
def with_memory_cache
|
def with_memory_cache
|
||||||
|
|||||||
Reference in new issue
Block a user