mirror of
https://github.com/rickbarrette/redmine_qbo.git
synced 2026-11-17 18:20:36 -05:00
- Estimates and invoices take a discount, as a percent of the subtotal or an amount, saved as QuickBooks' discount line and taken off before sales tax. Duplicated estimates and invoices made from an estimate keep it. The box is hidden when discounts are off in QuickBooks. - A paid invoice can be unlocked for editing after a confirmation. The payments stay linked, and the total can't go below what's been paid. Unlocking needs the new "Edit partially paid invoices" or "Edit paid invoices" permission, checked again when saving. - Saved payments can be edited: date, method, reference, memo, amount and the invoices they pay. Each invoice keeps its amount unless the amount or the invoices change. Payments that also apply credit memos stay read-only. - Locked estimates and invoices are readable again (disabled boxes had faint or invisible text, especially in Safari). Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
806 lines
37 KiB
ERB
806 lines
37 KiB
ERB
<%# Inline so the page never depends on precompiled plugin assets %>
|
||
<%= javascript_tag do %>
|
||
$(function () {
|
||
var $form = $('#qbo-estimate-form');
|
||
if (!$form.length) return;
|
||
|
||
// For other plugins' editor scripts (added through the view_qbo_estimate_form_bottom hook). The form also
|
||
// triggers these events (listen with $(document).on('qbo:imported', '#qbo-estimate-form', fn)):
|
||
// qbo:customer-changed (event, { customer_id, info }) info includes field_options
|
||
// qbo:imported (event, { issue_ids, estimates, issue_values }) after time/estimates are
|
||
// imported into an invoice; issue_values is { issue_id => { field_id => value } }
|
||
// and each estimate has its own custom_fields { field_id => value }
|
||
window.qboEditor = {
|
||
form: $form,
|
||
document: $form.data('document'),
|
||
// A QuickBooks custom field's box, by field id or by a name pattern (RegExp)
|
||
field: function (id) { return $('#qbo_custom_field_' + id); },
|
||
fieldNamed: function (pattern) {
|
||
var $box = $();
|
||
$form.find('.qbo-field-custom').each(function () {
|
||
if (!$box.length && pattern.test(String($(this).data('qboFieldName')))) $box = $(this).find('input.qbo-custom-field');
|
||
});
|
||
return $box;
|
||
},
|
||
fieldId: function ($box) { return $box.closest('.qbo-field-custom').data('qboFieldId'); },
|
||
// Replaces a box's suggestion list: [{ value, label }]
|
||
setFieldOptions: function (id, options) {
|
||
var $list = $('#qbo-custom-field-options-' + id).empty();
|
||
(options || []).forEach(function (o) { $('<option>').attr('value', o.value).text(o.label || o.value).appendTo($list); });
|
||
}
|
||
};
|
||
|
||
var $tbody = $('#qbo-estimate-lines tbody');
|
||
var template = document.getElementById('qbo-estimate-line-template').innerHTML;
|
||
var subtotalTemplate = document.getElementById('qbo-estimate-subtotal-template').innerHTML;
|
||
var money = new Intl.NumberFormat(<%= raw (current_language.to_s.presence || 'en').to_json %>, { style: 'currency', currency: 'USD' });
|
||
var savedSubtotal = $form.data('savedSubtotal') === '' ? null : parseFloat($form.data('savedSubtotal'));
|
||
var savedTax = $form.data('savedTax') === '' ? null : parseFloat($form.data('savedTax'));
|
||
// The discount QuickBooks took off when the document was last saved (the tax shown is for that discount)
|
||
var savedDiscount = $form.data('discount') === '' ? 0 : parseFloat($form.data('discount'));
|
||
var $discountValue = $('#qbo_estimate_discount_value');
|
||
var $discountType = $('#qbo_estimate_discount_type');
|
||
var locked = $form.find('.qbo-estimate-sheet').prop('disabled');
|
||
// Row keys must be digits: Rails' strong parameters only keep a hash of rows when every key is a number
|
||
var nextKey = Date.now();
|
||
var dirty = false;
|
||
|
||
// ---- numbers ----
|
||
// A number, or simple arithmetic typed into a quantity or rate box (e.g. 33*1.3, (120+15)/2): + - * / and
|
||
// parentheses only, worked out here (never run as code). null when empty, NaN when it can't be read.
|
||
function isMath(text) { return /[*\/()+x×]/.test(text) || /.-/.test(text); }
|
||
function evaluateMath(text) {
|
||
var tokens = text.replace(/[x×]/g, '*').match(/\d*\.?\d+|[-+*\/()]/g);
|
||
if (!tokens || tokens.join('') !== text.replace(/[x×]/g, '*')) return NaN;
|
||
var i = 0;
|
||
var peek = function () { return tokens[i]; };
|
||
var expr, term, factor;
|
||
factor = function () {
|
||
var t = tokens[i++];
|
||
if (t === '-') return -factor();
|
||
if (t === '+') return factor();
|
||
if (t === '(') { var v = expr(); if (tokens[i++] !== ')') return NaN; return v; }
|
||
return t !== undefined && /^\d*\.?\d+$/.test(t) ? parseFloat(t) : NaN;
|
||
};
|
||
term = function () {
|
||
var v = factor();
|
||
while (peek() === '*' || peek() === '/') { var op = tokens[i++], r = factor(); v = op === '*' ? v * r : v / r; }
|
||
return v;
|
||
};
|
||
expr = function () {
|
||
var v = term();
|
||
while (peek() === '+' || peek() === '-') { var op = tokens[i++], r = term(); v = op === '+' ? v + r : v - r; }
|
||
return v;
|
||
};
|
||
var result = expr();
|
||
return i === tokens.length && isFinite(result) ? result : NaN;
|
||
}
|
||
function parseNumber(value) {
|
||
var text = String(value == null ? '' : value).replace(/[$,\s]/g, '');
|
||
if (text === '') return null;
|
||
if (isMath(text)) return evaluateMath(text);
|
||
var n = Number(text);
|
||
return isFinite(n) ? n : NaN;
|
||
}
|
||
// Rounds half up exactly (1.005 -> 1.01; multiplying first would give 1.00)
|
||
function round(n, places) {
|
||
if (/e/i.test(String(n))) { var f = Math.pow(10, places); return Math.round(n * f) / f; }
|
||
return Number(Math.round(Number(n + 'e' + places)) + 'e-' + places);
|
||
}
|
||
function plain(n, places) { return String(round(n, places)); }
|
||
|
||
// ---- rows ----
|
||
function rows() { return $tbody.children('tr.qbo-line'); }
|
||
|
||
function isSubtotal($row) { return $row.hasClass('qbo-line-subtotal'); }
|
||
|
||
function rowIsBlank($row) {
|
||
if (isSubtotal($row)) return false;
|
||
return !$row.find('.qbo-line-item-id').val() && !$row.find('.qbo-line-item-name').val().trim() &&
|
||
!$row.find('.qbo-line-description-input').val().trim() && !$row.find('.qbo-line-rate-input').val().trim();
|
||
}
|
||
|
||
function addRow() {
|
||
var $row = $(template.replace(/__KEY__/g, String(nextKey++)));
|
||
$tbody.append($row);
|
||
setupRow($row);
|
||
renumber();
|
||
return $row;
|
||
}
|
||
|
||
// QuickBooks keeps a spare empty line at the bottom; filling it adds another
|
||
function ensureSpareRow() {
|
||
var $last = rows().last();
|
||
if (!$last.length || !rowIsBlank($last)) addRow();
|
||
}
|
||
|
||
function renumber() {
|
||
rows().each(function (i) { $(this).find('.qbo-line-number').text(i + 1); });
|
||
}
|
||
|
||
function autoGrow(textarea) {
|
||
textarea.style.height = 'auto';
|
||
textarea.style.height = (textarea.scrollHeight + 2) + 'px';
|
||
}
|
||
|
||
// Works out the line amount from qty x rate (qty defaults to 1, like QuickBooks)
|
||
function lineAmount($row) {
|
||
var rate = parseNumber($row.find('.qbo-line-rate-input').val());
|
||
if (rate === null || isNaN(rate)) return null;
|
||
var qty = parseNumber($row.find('.qbo-line-qty-input').val());
|
||
if (qty === null) qty = 1;
|
||
if (isNaN(qty)) return null;
|
||
return round(qty * rate, 2);
|
||
}
|
||
|
||
// The discount in dollars: a percent of the subtotal or an amount, like QuickBooks works it out
|
||
function discountAmount(subtotal) {
|
||
var value = parseNumber(String($discountValue.val() || '').replace(/%/g, ''));
|
||
if (!$discountValue.length || value === null || isNaN(value) || value <= 0) return 0;
|
||
return $discountType.val() === 'percent' ? round(subtotal * value / 100, 2) : round(value, 2);
|
||
}
|
||
|
||
function recalc() {
|
||
var subtotal = 0, taxable = 0, section = 0;
|
||
rows().each(function () {
|
||
var $row = $(this);
|
||
// A subtotal row totals the lines since the previous subtotal
|
||
if (isSubtotal($row)) {
|
||
$row.find('.qbo-line-subtotal-amount').text(money.format(round(section, 2)));
|
||
section = 0;
|
||
return;
|
||
}
|
||
var amount = lineAmount($row);
|
||
var $amount = $row.find('.qbo-line-amount-input');
|
||
if (!$amount.is(':focus')) $amount.val(amount === null ? '' : amount.toFixed(2));
|
||
if (amount !== null) {
|
||
subtotal += amount;
|
||
section += amount;
|
||
if ($row.find('.qbo-line-taxable').is(':checked')) taxable += amount;
|
||
}
|
||
});
|
||
subtotal = round(subtotal, 2);
|
||
|
||
// QuickBooks works out the sales tax when the estimate is saved; show the saved tax until the lines change
|
||
var $tax = $('#qbo-estimate-tax');
|
||
var discount = discountAmount(subtotal);
|
||
$('#qbo-estimate-discount').text(discount > 0 ? '-' + money.format(discount) : '');
|
||
var total = round(subtotal - discount, 2);
|
||
if (savedTax !== null && savedSubtotal !== null && Math.abs(subtotal - savedSubtotal) < 0.005 &&
|
||
Math.abs(discount - savedDiscount) < 0.005) {
|
||
$tax.text(money.format(savedTax)).removeClass('qbo-pending');
|
||
total = round(total + savedTax, 2);
|
||
} else {
|
||
$tax.text($tax.data('pendingText')).addClass('qbo-pending');
|
||
}
|
||
|
||
$('#qbo-estimate-subtotal').text(money.format(subtotal));
|
||
$('#qbo-estimate-taxable-subtotal').text(money.format(round(taxable, 2)));
|
||
$('#qbo-estimate-total').text(money.format(total));
|
||
$('#qbo-estimate-amount').text(money.format(total));
|
||
}
|
||
|
||
// ---- product/service search ----
|
||
|
||
// Fills a line from a product/service: name, id, description (unless the user typed their own), rate,
|
||
// quantity 1 if empty, taxable
|
||
function applyItem($input, item) {
|
||
var $row = $input.closest('tr');
|
||
var $description = $row.find('.qbo-line-description-input');
|
||
var previous = $row.data('itemDescription');
|
||
|
||
$input.val(item.name);
|
||
$row.find('.qbo-line-item-id').val(item.id);
|
||
$row.removeClass('qbo-line-unmatched');
|
||
// Keep a description the user typed; replace one that came from the previous product
|
||
if (!$description.val().trim() || $description.val() === previous) {
|
||
$description.val(item.description || '');
|
||
autoGrow($description[0]);
|
||
// Tabbed into it already (the product was filled in after the search came back): keep it selected
|
||
if (document.activeElement === $description[0]) $description[0].select();
|
||
}
|
||
$row.data('itemDescription', item.description || '');
|
||
if (item.price !== null && item.price !== undefined && item.price !== '') {
|
||
$row.find('.qbo-line-rate-input').val(plain(parseFloat(item.price), 5));
|
||
tidyNumbers($row);
|
||
}
|
||
if (!$row.find('.qbo-line-qty-input').val().trim()) $row.find('.qbo-line-qty-input').val('1');
|
||
$row.find('.qbo-line-taxable').prop('checked', item.taxable !== false);
|
||
changed();
|
||
}
|
||
|
||
// Keyboard subtotal: typed in a line's product box, then Tab or Enter
|
||
var SUBTOTAL_SHORTCUTS = ['sub', 'subtotal', '='];
|
||
|
||
// Puts a subtotal where the shortcut was typed: an otherwise empty line becomes the subtotal; a line with a
|
||
// description, quantity or rate keeps them (the shortcut text is cleared) and the subtotal goes after it.
|
||
// Then the next line's product box gets the focus, to carry on typing.
|
||
function insertSubtotalAt($row) {
|
||
var $subtotal = $(subtotalTemplate.replace(/__KEY__/g, String(nextKey++)));
|
||
var $product = $row.find('.qbo-line-item-name');
|
||
var otherwiseEmpty = !$row.find('.qbo-line-description-input').val().trim() &&
|
||
!$row.find('.qbo-line-qty-input').val().trim() && !$row.find('.qbo-line-rate-input').val().trim();
|
||
if (otherwiseEmpty) {
|
||
$row.replaceWith($subtotal);
|
||
} else {
|
||
$product.val('');
|
||
$row.removeClass('qbo-line-unmatched').after($subtotal);
|
||
}
|
||
renumber();
|
||
changed();
|
||
var $next = $subtotal.nextAll('tr.qbo-line').not('.qbo-line-subtotal').first();
|
||
if (!$next.length) $next = addRow();
|
||
$next.find('.qbo-line-item-name').trigger('focus');
|
||
}
|
||
|
||
// The product typed text points to: an exact name match, else the only result, else the only one whose name
|
||
// starts with the text (e.g. "lab" -> Labor). Nothing when it's ambiguous.
|
||
function bestItem(term, items) {
|
||
var t = term.trim().toLowerCase();
|
||
if (!t || !items || !items.length) return null;
|
||
var exact = items.filter(function (i) { return String(i.name).toLowerCase() === t; });
|
||
if (exact.length === 1) return exact[0];
|
||
if (items.length === 1) return items[0];
|
||
var starts = items.filter(function (i) { return String(i.name).toLowerCase().indexOf(t) === 0; });
|
||
return starts.length === 1 ? starts[0] : null;
|
||
}
|
||
|
||
function setupItemSearch($input) {
|
||
$input.autocomplete({
|
||
appendTo: 'body',
|
||
minLength: 0,
|
||
delay: 150,
|
||
source: function (request, response) {
|
||
$.getJSON($form.data('itemsUrl'), { q: request.term })
|
||
.done(function (items) {
|
||
$input.data('qboResults', { term: request.term, items: items });
|
||
response(items.map(function (item) {
|
||
return { label: item.name, value: item.name, item: item };
|
||
}));
|
||
})
|
||
.fail(function () { response([]); });
|
||
},
|
||
select: function (event, ui) {
|
||
applyItem($input, ui.item.item);
|
||
return false;
|
||
}
|
||
});
|
||
|
||
// Typing "sub", "subtotal" or "=" then Tab or Enter makes a subtotal here (see insertSubtotalAt)
|
||
$input.on('keydown', function (event) {
|
||
if ((event.key !== 'Tab' && event.key !== 'Enter') || event.shiftKey) return;
|
||
var $row = $input.closest('tr');
|
||
if (SUBTOTAL_SHORTCUTS.indexOf($input.val().trim().toLowerCase()) < 0 || $row.find('.qbo-line-item-id').val()) return;
|
||
event.preventDefault();
|
||
event.stopImmediatePropagation();
|
||
var search = $input.autocomplete('instance');
|
||
clearTimeout(search.searching);
|
||
search.cancelSearch = true;
|
||
$input.autocomplete('close');
|
||
insertSubtotalAt($row);
|
||
});
|
||
|
||
// Tab picks the product the text points to (an item highlighted in the list is picked by the
|
||
// autocomplete itself). If the search hasn't come back yet, the line is filled in when it does.
|
||
$input.on('keydown', function (event) {
|
||
if (event.key !== 'Tab' || event.shiftKey) return;
|
||
var menu = $input.autocomplete('instance').menu;
|
||
if (menu && menu.active) return;
|
||
var $row = $input.closest('tr');
|
||
var term = $input.val();
|
||
if ($row.find('.qbo-line-item-id').val() || !term.trim()) return;
|
||
|
||
var known = $input.data('qboResults');
|
||
if (known && known.term.trim().toLowerCase() === term.trim().toLowerCase()) {
|
||
var pick = bestItem(term, known.items);
|
||
if (pick) applyItem($input, pick);
|
||
$input.autocomplete('close');
|
||
return;
|
||
}
|
||
$.getJSON($form.data('itemsUrl'), { q: term }).done(function (items) {
|
||
var pick = bestItem(term, items);
|
||
if (pick && $input.val() === term && !$row.find('.qbo-line-item-id').val()) applyItem($input, pick);
|
||
});
|
||
});
|
||
|
||
$input.autocomplete('instance')._renderItem = function (ul, entry) {
|
||
var item = entry.item;
|
||
var $div = $('<div>');
|
||
if (item.price !== null && item.price !== undefined && item.price !== '') {
|
||
$('<span class="qbo-item-option-price">').text(money.format(parseFloat(item.price))).appendTo($div);
|
||
}
|
||
$('<strong>').text(item.name).appendTo($div);
|
||
var meta = [item.sku, item.description].filter(function (s) { return s; }).join(' · ');
|
||
if (meta) $('<div class="qbo-item-option-meta">').text(meta.length > 90 ? meta.slice(0, 90) + '…' : meta).appendTo($div);
|
||
return $('<li>').append($div).appendTo(ul);
|
||
};
|
||
|
||
// Like QuickBooks, the list opens when the box is clicked
|
||
$input.on('focus', function () {
|
||
if (!$input.val()) $input.autocomplete('search', '');
|
||
});
|
||
|
||
// Typing a different name unlinks the product until one is picked from the list
|
||
$input.on('input', function () {
|
||
var $row = $input.closest('tr');
|
||
$row.find('.qbo-line-item-id').val('');
|
||
$row.toggleClass('qbo-line-unmatched', $input.val().trim() !== '');
|
||
});
|
||
}
|
||
|
||
function setupRow($row) {
|
||
if (isSubtotal($row) || $row.data('qboSetup')) return;
|
||
$row.data('qboSetup', true);
|
||
setupItemSearch($row.find('.qbo-line-item-name'));
|
||
$row.find('.qbo-line-description-input').each(function () { autoGrow(this); });
|
||
$row.data('itemDescription', $row.find('.qbo-line-item-id').val() ? $row.find('.qbo-line-description-input').val() : null);
|
||
}
|
||
|
||
function changed() {
|
||
dirty = true;
|
||
recalc();
|
||
ensureSpareRow();
|
||
}
|
||
|
||
// ---- keyboard ----
|
||
// Tabbing into a line's description, quantity or rate selects what's there, so typing replaces it (a click
|
||
// still places the cursor)
|
||
var tabbedAt = 0;
|
||
$(document).on('keydown', function (event) { if (event.key === 'Tab') tabbedAt = Date.now(); });
|
||
// A click right after a Tab is still a click
|
||
$(document).on('mousedown touchstart', function () { tabbedAt = 0; });
|
||
$tbody.on('focus', '.qbo-line-description-input, .qbo-line-qty-input, .qbo-line-rate-input', function () {
|
||
if (Date.now() - tabbedAt > 500) return;
|
||
// Right away, so the first key typed already replaces the text; and again once the browser has placed
|
||
// its cursor (a textarea, the description, puts it back at the start), unless typing has begun
|
||
var box = this, before = box.value;
|
||
$(box).data('qboTabbedValue', before);
|
||
box.select();
|
||
setTimeout(function () { if (document.activeElement === box && box.value === before) box.select(); }, 0);
|
||
});
|
||
// Some browsers (Safari, Firefox) place the cursor after that; the Tab key's release arrives here once they
|
||
// have, so select again if nothing was typed yet
|
||
$tbody.on('keyup', '.qbo-line-description-input, .qbo-line-qty-input, .qbo-line-rate-input', function (event) {
|
||
if (event.key !== 'Tab') return;
|
||
var tabbed = $(this).data('qboTabbedValue');
|
||
$(this).removeData('qboTabbedValue');
|
||
if (tabbed !== undefined && this.value === tabbed) this.select();
|
||
});
|
||
|
||
// ---- line events ----
|
||
$tbody.on('input', '.qbo-line-qty-input, .qbo-line-rate-input, .qbo-line-description-input, .qbo-line-item-name', changed);
|
||
$tbody.on('change', '.qbo-line-taxable', changed);
|
||
$tbody.on('input', '.qbo-line-description-input', function () { autoGrow(this); });
|
||
|
||
// Typing an amount (or math, e.g. 300*1.1, rounded to the penny) works out the rate from the quantity
|
||
$tbody.on('input', '.qbo-line-amount-input', function () {
|
||
var $row = $(this).closest('tr');
|
||
var amount = parseNumber($(this).val());
|
||
if (amount === null || isNaN(amount)) return;
|
||
if (isMath($(this).val().replace(/[$,\s]/g, ''))) amount = round(amount, 2);
|
||
var qty = parseNumber($row.find('.qbo-line-qty-input').val());
|
||
if (qty === null || isNaN(qty) || qty === 0) qty = 1;
|
||
$row.find('.qbo-line-rate-input').val(plain(amount / qty, 5));
|
||
changed();
|
||
});
|
||
|
||
// Rates show cents (1120 -> 1120.00) unless they need more places; quantities stay plain
|
||
function tidyNumbers($row) {
|
||
$row.find('.qbo-line-qty-input, .qbo-line-rate-input').each(function () {
|
||
var n = parseNumber(this.value);
|
||
if (n === null || isNaN(n)) return;
|
||
var isRate = $(this).hasClass('qbo-line-rate-input');
|
||
// Math in the rate box is rounded to the nearest penny
|
||
if (isRate && isMath(this.value.replace(/[$,\s]/g, ''))) n = round(n, 2);
|
||
this.value = isRate && round(n, 2) === round(n, 5) ? n.toFixed(2) : plain(n, 5);
|
||
});
|
||
}
|
||
$tbody.on('blur', '.qbo-line-rate-input, .qbo-line-qty-input, .qbo-line-amount-input', function () {
|
||
tidyNumbers($(this).closest('tr'));
|
||
recalc();
|
||
});
|
||
|
||
$tbody.on('click', '.qbo-line-remove-button', function () {
|
||
var $row = $(this).closest('tr');
|
||
if (rows().length > 1) {
|
||
$row.remove();
|
||
} else {
|
||
$row.find('input[type=text], textarea, .qbo-line-item-id').val('');
|
||
$row.removeClass('qbo-line-unmatched');
|
||
}
|
||
renumber();
|
||
changed();
|
||
});
|
||
|
||
$('#qbo-estimate-add-lines').on('click', function () {
|
||
for (var i = 0; i < 4; i++) addRow();
|
||
dirty = true;
|
||
});
|
||
|
||
// A subtotal goes after the last filled line, above the spare empty rows
|
||
$('#qbo-estimate-add-subtotal').on('click', function () {
|
||
var $subtotal = $(subtotalTemplate.replace(/__KEY__/g, String(nextKey++)));
|
||
var $filled = rows().filter(function () { return !rowIsBlank($(this)); });
|
||
if ($filled.length) { $filled.last().after($subtotal); } else { $tbody.prepend($subtotal); }
|
||
renumber();
|
||
changed();
|
||
});
|
||
|
||
$('#qbo-estimate-clear-lines').on('click', function () {
|
||
function clearLines() {
|
||
rows().remove();
|
||
addRow(); addRow();
|
||
changed();
|
||
}
|
||
// redmine_dark_mode asks in a dark dialog on dark pages; otherwise the browser's own box
|
||
var message = $(this).data('confirmText');
|
||
if (window.RedmineDarkMode && window.RedmineDarkMode.confirm) {
|
||
window.RedmineDarkMode.confirm(message, clearLines);
|
||
} else if (window.confirm(message)) {
|
||
clearLines();
|
||
}
|
||
});
|
||
|
||
// Drag lines by the handle to reorder them; they're saved in table order
|
||
$tbody.sortable({
|
||
handle: '.qbo-line-handle',
|
||
axis: 'y',
|
||
items: '> tr.qbo-line',
|
||
placeholder: 'qbo-line-placeholder',
|
||
helper: function (event, tr) {
|
||
var $originals = tr.children();
|
||
var $helper = tr.clone();
|
||
$helper.children().each(function (i) { $(this).width($originals.eq(i).outerWidth()); });
|
||
return $helper;
|
||
},
|
||
start: function (event, ui) { ui.placeholder.html('<td colspan="9"></td>'); },
|
||
// Moving a line or a subtotal changes what each subtotal covers
|
||
update: function () { renumber(); changed(); }
|
||
});
|
||
|
||
// ---- customer ----
|
||
var $email = $('#qbo_estimate_email');
|
||
var loadedEmail = $email.val();
|
||
|
||
$('#customer_id').on('change', function () {
|
||
var id = $(this).val();
|
||
if (!id) return;
|
||
dirty = true;
|
||
$.getJSON($form.data('customerInfoUrl'), { customer_id: id, document: $form.data('document') }).done(function (info) {
|
||
// A new invoice's open issues notice follows the customer
|
||
if (info.open_issues_html !== undefined) $('#qbo-open-issues').replaceWith(info.open_issues_html);
|
||
// Replace the email only if it was the previous customer's (or empty)
|
||
if (!$email.val().trim() || $email.val() === loadedEmail) $email.val(info.email || '');
|
||
loadedEmail = info.email || '';
|
||
$('#qbo-estimate-address').text(info.billing_address || '');
|
||
|
||
// Plugins' suggestions for this customer go in the custom field boxes' lists; the boxes themselves
|
||
// stay as they are (a new document starts blank)
|
||
$form.find('.qbo-field-custom').each(function () {
|
||
var fieldId = $(this).data('qboFieldId');
|
||
window.qboEditor.setFieldOptions(fieldId, (info.field_options || {})[String(fieldId)]);
|
||
});
|
||
$form.trigger('qbo:customer-changed', [{ customer_id: id, info: info }]);
|
||
});
|
||
});
|
||
|
||
// Clearing the customer name clears the customer
|
||
$('#qbo_estimate_customer_name').on('input', function () {
|
||
if (!this.value.trim()) $('#customer_id').val('');
|
||
});
|
||
|
||
// New estimates expire a set number of days after the estimate date (plugin setting)
|
||
var expirationDays = parseInt($form.data('expirationDays'), 10) || 0;
|
||
var $txnDate = $('#qbo_estimate_txn_date');
|
||
var $expiration = $('#qbo_estimate_expiration_date');
|
||
function addDays(iso, days) {
|
||
var parts = iso.split('-').map(Number);
|
||
var date = new Date(Date.UTC(parts[0], parts[1] - 1, parts[2] + days));
|
||
return date.toISOString().slice(0, 10);
|
||
}
|
||
if (expirationDays > 0) {
|
||
var lastDefault = $txnDate.val() ? addDays($txnDate.val(), expirationDays) : '';
|
||
$txnDate.on('change', function () {
|
||
if (!this.value) return;
|
||
// Only move a date that's still the default (or empty), not one picked by hand
|
||
if (!$expiration.val() || $expiration.val() === lastDefault) {
|
||
lastDefault = addDays(this.value, expirationDays);
|
||
$expiration.val(lastDefault);
|
||
}
|
||
});
|
||
}
|
||
|
||
// ---- invoices: import billable time and open estimates ----
|
||
var $panel = $('#qbo-import-panel');
|
||
if ($panel.length) {
|
||
var importData = null;
|
||
var undoState = null;
|
||
var $status = $('#qbo-import-status');
|
||
|
||
var setStatus = function (text) { $status.text(text || ''); };
|
||
var linkedEstimateIds = function () {
|
||
return $('#qbo-linked-estimates input').map(function () { return this.value; }).get();
|
||
};
|
||
var timeIdsInForm = function () {
|
||
return $tbody.find('.qbo-line-time-id').map(function () { return this.value; }).get().filter(Boolean);
|
||
};
|
||
|
||
// A new row (not yet in the table) filled with an imported line
|
||
var makeRow = function (line) {
|
||
if (line.kind === 'subtotal') return $(subtotalTemplate.replace(/__KEY__/g, String(nextKey++)));
|
||
var $row = $(template.replace(/__KEY__/g, String(nextKey++)));
|
||
$row.find('.qbo-line-item-id').val(line.item_id || '');
|
||
$row.find('.qbo-line-item-name').val(line.item_name || '');
|
||
$row.find('.qbo-line-description-input').val(line.description || '');
|
||
$row.find('.qbo-line-qty-input').val(line.quantity || '');
|
||
$row.find('.qbo-line-rate-input').val(line.rate || '');
|
||
$row.find('.qbo-line-taxable').prop('checked', !!line.taxable);
|
||
if (line.time_activity_id) {
|
||
$row.find('.qbo-line-time-id').val(line.time_activity_id);
|
||
$row.addClass('qbo-line-time');
|
||
}
|
||
return $row;
|
||
};
|
||
|
||
// The issue a line came from: "Install #116: some job" on time, "Added from: Install #116: ..." on estimates
|
||
var issueOf = function (text) {
|
||
var match = /#(\d+):/.exec((text || '').split('\n')[0]);
|
||
return match ? match[1] : null;
|
||
};
|
||
|
||
// The last time line on the invoice for the issue
|
||
var timeRowForIssue = function (issueId) {
|
||
return rows().filter(function () {
|
||
var $row = $(this);
|
||
return $row.hasClass('qbo-line-time') && issueOf($row.find('.qbo-line-description-input').val()) === issueId;
|
||
}).last();
|
||
};
|
||
|
||
// Issues behind the invoice's time lines and "Added from" notes
|
||
var invoiceIssueIds = function () {
|
||
var ids = [];
|
||
rows().each(function () {
|
||
var $row = $(this);
|
||
if (isSubtotal($row)) return;
|
||
var description = $row.find('.qbo-line-description-input').val() || '';
|
||
if (!$row.hasClass('qbo-line-time') && !/^\s*Added from:/i.test(description)) return;
|
||
var id = issueOf(description);
|
||
if (id && ids.indexOf(id) < 0) ids.push(id);
|
||
});
|
||
return ids;
|
||
};
|
||
|
||
// Pairs imported time with the invoice lines ticked under "Replace these lines": first by description,
|
||
// since issues created from an estimate take the line's description as their subject and the time names
|
||
// it ("Install #134: Install Lift Kit" <-> "Install Lift Kit"); what's left is paired in order.
|
||
// Returns { pairs: [{ time, line }], extraTimes: [...], extraLines: [...] }.
|
||
var pairTimeWithLines = function (times, lines) {
|
||
var norm = function (text) { return String(text || '').split('\n')[0].toLowerCase().replace(/\s+/g, ' ').trim(); };
|
||
var subject = function (activity) { return norm(String(activity.description || '').replace(/^[^\n]*?#\d+:\s*/, '')); };
|
||
var lineText = function (line) { return norm($(line).find('.qbo-line-description-input').val()); };
|
||
var freeTimes = times.slice(), freeLines = [], pairs = [];
|
||
lines.forEach(function (line) {
|
||
var text = lineText(line);
|
||
var i = text ? freeTimes.findIndex(function (t) { return subject(t) === text; }) : -1;
|
||
if (i >= 0) { pairs.push({ time: freeTimes[i], line: line }); freeTimes.splice(i, 1); } else { freeLines.push(line); }
|
||
});
|
||
while (freeTimes.length && freeLines.length) pairs.push({ time: freeTimes.shift(), line: freeLines.shift() });
|
||
return { pairs: pairs, extraTimes: freeTimes, extraLines: freeLines };
|
||
};
|
||
|
||
// Rows go after the last filled line, above the spare empty rows
|
||
var insertAfterFilled = function ($rows) {
|
||
var $filled = rows().filter(function () { return !rowIsBlank($(this)); });
|
||
if ($filled.length) { $filled.last().after($rows); } else { $tbody.prepend($rows); }
|
||
};
|
||
|
||
var lineLabel = function ($row) {
|
||
var item = $row.find('.qbo-line-item-name').val();
|
||
var description = ($row.find('.qbo-line-description-input').val() || '').split('\n')[0];
|
||
var amount = $row.find('.qbo-line-amount-input').val();
|
||
return '#' + $row.find('.qbo-line-number').text().trim() + ' ' + [item, description].filter(Boolean).join(' – ') +
|
||
(amount ? ' (' + money.format(parseFloat(amount)) + ')' : '');
|
||
};
|
||
|
||
// The invoice's lines, for ticking the ones the time replaces (e.g. the estimate's labor lines).
|
||
// Only lines with one of the labor products/services (plugin settings) are offered; if none are known,
|
||
// every line is.
|
||
var replaceable = ($form.data('laborItemIds') || []).map(String);
|
||
var fillReplaceList = function () {
|
||
var $list = $('#qbo-import-replace').empty();
|
||
rows().each(function () {
|
||
var $row = $(this);
|
||
if (isSubtotal($row) || rowIsBlank($row) || $row.hasClass('qbo-line-time')) return;
|
||
if (replaceable.length && replaceable.indexOf(String($row.find('.qbo-line-item-id').val())) < 0) return;
|
||
var $box = $('<input type="checkbox">').data('row', $row);
|
||
$('<li>').append($('<label>').append($box, ' ', document.createTextNode(lineLabel($row)))).appendTo($list);
|
||
});
|
||
if (!$list.children().length) $('<li>').text($panel.data('noneText')).appendTo($list);
|
||
};
|
||
|
||
var emptyRow = function ($tbodyEl, columns) {
|
||
$('<tr>').append($('<td>').attr('colspan', columns).addClass('qbo-import-none').text($panel.data('noneText'))).appendTo($tbodyEl);
|
||
};
|
||
|
||
var renderImport = function () {
|
||
var used = timeIdsInForm();
|
||
var linked = linkedEstimateIds();
|
||
var $time = $('#qbo-import-time tbody').empty();
|
||
importData.time_activities.forEach(function (activity, index) {
|
||
if (used.indexOf(activity.id) >= 0) return;
|
||
$('<tr>').append(
|
||
$('<td>').append($('<input type="checkbox" class="qbo-import-pick">').val(index)),
|
||
$('<td>').text(activity.date),
|
||
$('<td>').text(activity.item_name || ''),
|
||
$('<td>').text([activity.employee, activity.description].filter(Boolean).join(': ')),
|
||
$('<td class="qbo-num">').text(activity.quantity),
|
||
$('<td class="qbo-num">').text(money.format(parseFloat(activity.amount)))
|
||
).appendTo($time);
|
||
});
|
||
if (!$time.children().length) emptyRow($time, 6);
|
||
|
||
var $estimates = $('#qbo-import-estimates tbody').empty();
|
||
importData.estimates.forEach(function (estimate, index) {
|
||
if (linked.indexOf(estimate.id) >= 0) return;
|
||
var first = estimate.lines.filter(function (l) { return l.description; })[0];
|
||
$('<tr>').append(
|
||
$('<td>').append($('<input type="checkbox" class="qbo-import-pick">').val(index)),
|
||
$('<td>').text('#' + estimate.doc_number),
|
||
$('<td>').text(estimate.date),
|
||
$('<td>').text(estimate.issue || (first ? first.description.split('\n')[0] : '')),
|
||
$('<td class="qbo-num">').text(money.format(parseFloat(estimate.total || 0)))
|
||
).appendTo($estimates);
|
||
});
|
||
if (!$estimates.children().length) emptyRow($estimates, 5);
|
||
};
|
||
|
||
$('#qbo-import-open').on('click', function () {
|
||
$panel.prop('hidden', false);
|
||
importData = null;
|
||
$('#qbo-import-time tbody, #qbo-import-estimates tbody').empty();
|
||
fillReplaceList();
|
||
var customerId = $('#customer_id').val();
|
||
if (!customerId) { setStatus($panel.data('needCustomerText')); return; }
|
||
setStatus($panel.data('loadingText'));
|
||
$.getJSON($form.data('importUrl'), { customer_id: customerId, issue_ids: invoiceIssueIds() })
|
||
.done(function (data) { importData = data; renderImport(); setStatus(''); })
|
||
.fail(function (xhr) { setStatus((xhr.responseJSON && xhr.responseJSON.error) || xhr.statusText); });
|
||
});
|
||
|
||
$('#qbo-import-close').on('click', function () { $panel.prop('hidden', true); });
|
||
|
||
$panel.on('change', '.qbo-import-all', function () {
|
||
$('#' + $(this).data('target') + ' .qbo-import-pick').prop('checked', this.checked);
|
||
});
|
||
|
||
$('#qbo-import-add').on('click', function () {
|
||
if (!importData) return;
|
||
var times = $('#qbo-import-time .qbo-import-pick:checked').map(function () { return importData.time_activities[this.value]; }).get();
|
||
var estimates = $('#qbo-import-estimates .qbo-import-pick:checked').map(function () { return importData.estimates[this.value]; }).get();
|
||
if (!times.length && !estimates.length) return;
|
||
|
||
// Kept so the import can be undone before saving (clones keep what was typed)
|
||
undoState = { rows: rows().clone(), linked: $('#qbo-linked-estimates').children().clone() };
|
||
|
||
// Each time entry replaces one ticked line, in that line's place (see pairTimeWithLines). Time left over
|
||
// goes after the last replaced line; ticked lines left over are removed (ticked means replace).
|
||
if (times.length) {
|
||
var ticked = $('#qbo-import-replace input:checked').map(function () { return $(this).data('row')[0]; }).get();
|
||
ticked = rows().get().filter(function (row) { return ticked.indexOf(row) >= 0; }); // table order
|
||
var pairing = pairTimeWithLines(times, ticked);
|
||
var timeRow = function (activity) { return makeRow($.extend({}, activity, { time_activity_id: activity.id })); };
|
||
var $last = $();
|
||
pairing.pairs.forEach(function (pair) {
|
||
var $row = timeRow(pair.time);
|
||
$(pair.line).replaceWith($row);
|
||
if (!$last.length || $row.index() > $last.index()) $last = $row;
|
||
});
|
||
pairing.extraLines.forEach(function (line) { $(line).remove(); });
|
||
if (pairing.extraTimes.length) {
|
||
var $extra = $(pairing.extraTimes.map(function (activity) { return timeRow(activity)[0]; }));
|
||
if ($last.length) { $last.after($extra); } else { insertAfterFilled($extra); }
|
||
}
|
||
}
|
||
|
||
// Each estimate's lines go right after the time for the same issue (e.g. lineitems' "Added from:
|
||
// Install #116" estimate after the time for #116), and its "Added from" note is dropped since the time
|
||
// line already names the issue. Estimates with no matching time keep the note and go at the end.
|
||
// The estimate is linked and closed when the invoice is saved.
|
||
var isAddedFromNote = function (line) {
|
||
return !line.kind && !line.item_id && !line.rate && /^\s*Added from:/i.test(line.description || '');
|
||
};
|
||
var lastForIssue = {};
|
||
estimates.forEach(function (estimate) {
|
||
var issueId = estimate.issue_id ? String(estimate.issue_id) : null;
|
||
var $anchor = issueId ? (lastForIssue[issueId] || timeRowForIssue(issueId)) : $();
|
||
var placed = !!($anchor && $anchor.length);
|
||
var lines = placed ? estimate.lines.filter(function (line) { return !isAddedFromNote(line); }) : estimate.lines;
|
||
var $estimateRows = $(lines.map(function (line) { return makeRow(line)[0]; }));
|
||
if (!$estimateRows.length) {
|
||
// Nothing but the note: nothing to add
|
||
} else if (placed) {
|
||
$anchor.after($estimateRows);
|
||
lastForIssue[issueId] = $estimateRows.last();
|
||
} else {
|
||
insertAfterFilled($estimateRows);
|
||
}
|
||
$('<input type="hidden" name="estimate[linked_estimate_ids][]">').val(estimate.id).appendTo('#qbo-linked-estimates');
|
||
});
|
||
|
||
rows().each(function () { setupRow($(this)); tidyNumbers($(this)); });
|
||
renumber();
|
||
changed();
|
||
|
||
// Imported estimates' notes are dropped next to their time, so their issues are added here
|
||
var issueIds = invoiceIssueIds();
|
||
estimates.forEach(function (estimate) {
|
||
if (estimate.issue_id && issueIds.indexOf(String(estimate.issue_id)) < 0) issueIds.push(String(estimate.issue_id));
|
||
});
|
||
$panel.prop('hidden', true);
|
||
// Plugins fill their custom fields from the work orders (e.g. redmine_qbo_vehicles: VIN and mileage)
|
||
$form.trigger('qbo:imported', [{ issue_ids: issueIds, estimates: estimates,
|
||
issue_values: (importData && importData.issue_values) || {} }]);
|
||
$('#qbo-import-undo').prop('hidden', false);
|
||
});
|
||
|
||
$('#qbo-import-undo').on('click', function () {
|
||
if (!undoState) return;
|
||
$tbody.empty().append(undoState.rows);
|
||
$('#qbo-linked-estimates').empty().append(undoState.linked);
|
||
undoState = null;
|
||
rows().each(function () { setupRow($(this)); });
|
||
renumber();
|
||
changed();
|
||
$(this).prop('hidden', true);
|
||
});
|
||
}
|
||
|
||
$discountValue.on('input', function () { dirty = true; recalc(); });
|
||
$discountType.on('change', function () { dirty = true; recalc(); });
|
||
// Math typed in the discount box (e.g. 1500-1250) is worked out, to the cent
|
||
function tidyDiscount() {
|
||
var text = String($discountValue.val() || '').replace(/[$,\s%]/g, '');
|
||
var value = parseNumber(text);
|
||
if (value !== null && !isNaN(value) && isMath(text)) $discountValue.val(plain(round(value, 2), 2));
|
||
}
|
||
$discountValue.on('blur', function () { tidyDiscount(); recalc(); });
|
||
|
||
// ---- saving ----
|
||
$form.on('input change', '.qbo-estimate-top input, .qbo-estimate-details input, .qbo-estimate-notes textarea', function () { dirty = true; });
|
||
|
||
// Enter in a text box shouldn't save the estimate half-written
|
||
$form.on('keydown', 'input[type=text], input[type=date]', function (event) {
|
||
if (event.key === 'Enter' && !$(this).closest('.ui-autocomplete').length) event.preventDefault();
|
||
});
|
||
|
||
$form.on('submit', function (event) {
|
||
var submitter = event.originalEvent && event.originalEvent.submitter;
|
||
if (submitter && submitter.id === 'qbo-estimate-save-and-send' && !$email.val().trim()) {
|
||
event.preventDefault();
|
||
window.alert($(submitter).data('needsEmailText'));
|
||
$email.trigger('focus');
|
||
return;
|
||
}
|
||
// Math still in a box is worked out before saving
|
||
rows().each(function () { tidyNumbers($(this)); });
|
||
tidyDiscount();
|
||
dirty = false;
|
||
});
|
||
|
||
window.addEventListener('beforeunload', function (event) {
|
||
if (!dirty || !$form.data('warnUnsaved')) return;
|
||
event.preventDefault();
|
||
event.returnValue = '';
|
||
});
|
||
|
||
rows().each(function () { tidyNumbers($(this)); });
|
||
|
||
// Estimates with bundles are shown read-only
|
||
if (locked) { recalc(); return; }
|
||
|
||
rows().each(function () { setupRow($(this)); });
|
||
ensureSpareRow();
|
||
recalc();
|
||
});
|
||
<% end %>
|