diff --git a/CHANGELOG.md b/CHANGELOG.md index 980d12cff..5fc11f426 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -2,6 +2,40 @@ This file documents all notable changes made to ITFlow. +## [26.09.3] Maint Release + +### Upgrading to 26.09.3 + +Update from Maintenance > Update — Queue Update hands the job to cron and it applies on its own. There is no database change in this release, so nothing else is required. + +### Breaking Changes and Notes + +- New tickets are now assigned to whoever is creating them. The assignee on the ticket form and on the client bulk-add form starts on your own name instead of Unassigned, and you can still pick anyone else or Unassigned before saving. +- API: a ticket created with an assignee now comes in as Open rather than New, matching what happens when an agent assigns a ticket by hand. Anything of yours that watches for New tickets to pick up work will no longer see assigned ones. +- Tax Summary and the dashboard Income by Category chart will show different numbers than they did before. Both were wrong wherever an invoice had been partly paid, and both usually read high. The corrected figures are described under Bug Fixes. + +### New Features & Updates + +- Invoices: a partly paid invoice shows what is still owed in red underneath the invoice total in the list, so you can see the outstanding balance without opening the invoice. + +### Bug Fixes + +- Invoices: the Unpaid figure at the top of the invoice list counted the whole of every partly paid invoice rather than what was left on it, and counted that invoice again for each payment against it. An invoice for $1,000 with three payments of $100 added $3,000 to Unpaid; it now adds the $700 that is actually outstanding. +- Reports: Tax Summary counted an invoice's full tax once per payment recorded against it, so a partly paid invoice with three payments reported three times its tax. Tax is now booked to the month the money came in, in proportion to how much of the invoice that payment covered, and each payment is counted once. Yearly totals also no longer disagree with the months they are made of. +- Dashboard: the Income by Category chart only counted invoices marked Paid, so partly paid invoices contributed nothing and revenues entered outside an invoice never appeared at all. It now counts payments and revenues as they land, matching the Cash Flow chart above it and the Income Summary report. +- Tickets: ticket-created emails told the client the status was Open no matter what the ticket was actually set to. They now carry the real status, on tickets an agent creates and on scheduled tickets from recurring tickets. +- Tickets: the assignee list on the client bulk-add form left out agents on the Accountant role and did not match the list on the normal ticket form. Both lists are now the same. +- Quotes and Recurring Invoices: picking a product from the item autocomplete put the word "undefined" in the item name, while the description and price filled in correctly. Invoices were not affected. The product list behind the box was also missing information on those two pages, so every entry read "No tax", services showed a stock badge, and searching by product code did not match. Reported by @cthompson. + +### Developer Updates + +- `getMonthlyTax()` and `getQuarterlyTax()` in `functions/app.php` are rewritten. They previously joined `invoice_items` to `invoices` to `payments`, which multiplied the line-item rows by the payment rows — the double counting was row multiplication, not a rounding problem. Both now drive off `payments`, join a pre-aggregated per-invoice tax subquery, and scale by `payment_amount / invoice_amount`, with `invoice_amount > 0` guarding the division. `agent/reports/tax_summary.php` also dropped a second loop that recalculated each row total by calling `getMonthlyTax()` another twelve times; the total accumulates in the first loop instead, cutting the queries behind the monthly view in half. +- `agent/invoices.php`: the Partial total no longer selects `SUM(invoice_amount)` across a `payments` join, and payments against partial invoices are subtracted from the unpaid figure. The list query gained a derived `LEFT JOIN (SELECT payment_invoice_id, SUM(payment_amount) ... GROUP BY payment_invoice_id)` for the per-row balance, which keeps it to one query rather than one per row. +- `agent/dashboard.php`: the `TopCategories` temporary table is now built from a `UNION ALL` of payments (carrying their invoice's category) and revenues, keyed on payment and revenue dates rather than `invoice_status = 'Paid'` and `invoice_date`. The Other bucket is built from the same union. +- `api/v1/tickets/create.php` sets `ticket_status = 2` when `assigned_to > 0`, rather than always inserting status 1. +- `agent/modals/client/client_bulk_add_ticket.php` filtered the assignee list on `user_role_id > 1` where every other assignee list uses `user_type = 1`. Role 1 is the built-in Accountant role, so accountant-role agents were missing from it. +- Product autocomplete is consolidated. The three pages each carried their own product `SELECT` and their own copy of the autocomplete JavaScript; the queries drifted, and quote and recurring invoice were still on a four-column version that had no `product_name` or `prod_id`, so the shared `onSelect` wrote `undefined` into `#name`. Its last line also assigned to `#product_id`, which only the invoice form has, so `onSelect` threw a `TypeError` on those two pages and the `input` handler under it threw on every keystroke. The query now lives in `getProductsForAutocomplete($mysqli)` in `functions/app.php` and the JavaScript in `js/product_autocomplete.js`, with the hidden `#product_id` added to the quote and recurring item forms and treated as optional in the JavaScript. Net 218 lines removed for 134 added. Note that `item_product_id` is still only written by `add_invoice_item` and the API, so the hidden field on those two forms is inert until the handlers are wired up. + ## [26.09.2] Maint Release - Updates the App Version to a proper version number. diff --git a/agent/dashboard.php b/agent/dashboard.php index 7355b1925..de218b403 100644 --- a/agent/dashboard.php +++ b/agent/dashboard.php @@ -1025,14 +1025,40 @@ if ($user_config_dashboard_technical_enable == 1) { data: { labels: [ 0 + UNION ALL + SELECT revenue_category_id AS income_category_id, revenue_amount AS amount + FROM revenues + WHERE YEAR(revenue_date) = $year AND revenue_category_id > 0) AS income + INNER JOIN categories ON category_id = income.income_category_id + GROUP BY category_name, category_id + ORDER BY total_income DESC LIMIT 5"); $sql_categories = mysqli_query($mysqli, "SELECT category_name FROM TopCategories"); while ($row = mysqli_fetch_assoc($sql_categories)) { $category_name = json_encode($row['category_name']); echo "$category_name,"; } - $sql_other_categories = mysqli_query($mysqli, "SELECT SUM(invoices.invoice_amount) AS other_income FROM categories LEFT JOIN TopCategories ON categories.category_id = TopCategories.category_id INNER JOIN invoices ON categories.category_id = invoices.invoice_category_id WHERE TopCategories.category_id IS NULL AND invoice_status = 'Paid' AND YEAR(invoice_date) = $year"); + $sql_other_categories = mysqli_query($mysqli, "SELECT SUM(income.amount) AS other_income + FROM (SELECT invoice_category_id AS income_category_id, payment_amount AS amount + FROM payments + INNER JOIN invoices ON invoice_id = payment_invoice_id + WHERE YEAR(payment_date) = $year AND invoice_category_id > 0 + UNION ALL + SELECT revenue_category_id AS income_category_id, revenue_amount AS amount + FROM revenues + WHERE YEAR(revenue_date) = $year AND revenue_category_id > 0) AS income + LEFT JOIN TopCategories ON TopCategories.category_id = income.income_category_id + WHERE TopCategories.category_id IS NULL"); $row = mysqli_fetch_assoc($sql_other_categories); $other_income = floatval($row['other_income']); if ($other_income > 0) { diff --git a/agent/invoice.php b/agent/invoice.php index 4bf4d071b..da87319da 100644 --- a/agent/invoice.php +++ b/agent/invoice.php @@ -180,32 +180,7 @@ if (isset($_GET['invoice_id'])) { $invoice_badge_color = getInvoiceBadgeColor($invoice_status); //Product autocomplete - $products_sql = mysqli_query($mysqli, " - SELECT - IF(product_code IS NULL OR product_code = '', product_name, CONCAT(product_code, ' - ', product_name)) AS label, - product_name, - product_code, - product_type AS type, - product_description AS description, - product_price AS price, - product_tax_id AS tax, - tax_percent, - product_id AS prod_id, - COALESCE(SUM(product_stock.stock_qty), 0) AS available_stock - FROM products - LEFT JOIN product_stock ON product_id = stock_product_id - LEFT JOIN taxes ON product_tax_id = tax_id - WHERE product_archived_at IS NULL - GROUP BY product_id - ORDER BY product_name ASC - "); - - if (mysqli_num_rows($products_sql) > 0) { - while ($row = mysqli_fetch_assoc($products_sql)) { - $products[] = $row; - } - $json_products = json_encode($products); - } + $json_products = getProductsForAutocomplete($mysqli); // Saved Payment Methods $sql_saved_payment_methods = mysqli_query($mysqli, " @@ -815,67 +790,12 @@ require_once "../includes/footer.php"; ?> - + + diff --git a/agent/invoices.php b/agent/invoices.php index 34d837f6d..6c91b2630 100644 --- a/agent/invoices.php +++ b/agent/invoices.php @@ -52,10 +52,13 @@ $sql_total_cancelled_amount = mysqli_query($mysqli, "SELECT SUM(invoice_amount) $row = mysqli_fetch_assoc($sql_total_cancelled_amount); $total_cancelled_amount = floatval($row['total_cancelled_amount']); -$sql_total_partial_amount = mysqli_query($mysqli, "SELECT SUM(invoice_amount) AS total_partial_amount FROM payments, invoices WHERE payment_invoice_id = invoice_id AND invoice_status = 'Partial' $client_query"); +$sql_total_partial_amount = mysqli_query($mysqli, "SELECT SUM(invoice_amount) AS total_partial_amount FROM invoices WHERE invoice_status = 'Partial' $client_query"); $row = mysqli_fetch_assoc($sql_total_partial_amount); $total_partial_amount = floatval($row['total_partial_amount']); -$total_partial_count = mysqli_num_rows($sql_total_partial_amount); + +$sql_total_partial_paid_amount = mysqli_query($mysqli, "SELECT SUM(payment_amount) AS total_partial_paid_amount FROM payments, invoices WHERE payment_invoice_id = invoice_id AND invoice_status = 'Partial' $client_query"); +$row = mysqli_fetch_assoc($sql_total_partial_paid_amount); +$total_partial_paid_amount = floatval($row['total_partial_paid_amount']); $sql_total_overdue_partial_amount = mysqli_query($mysqli, "SELECT SUM(payment_amount) AS total_overdue_partial_amount FROM payments, invoices WHERE payment_invoice_id = invoice_id AND invoice_status = 'Partial' AND invoice_due < CURDATE() $client_query"); $row = mysqli_fetch_assoc($sql_total_overdue_partial_amount); @@ -66,7 +69,7 @@ $row = mysqli_fetch_assoc($sql_total_overdue_amount); $total_overdue_amount = floatval($row['total_overdue_amount']); $real_overdue_amount = $total_overdue_amount - $total_overdue_partial_amount; -$total_unpaid_amount = $total_sent_amount + $total_viewed_amount + $total_partial_amount; +$total_unpaid_amount = $total_sent_amount + $total_viewed_amount + $total_partial_amount - $total_partial_paid_amount; $unpaid_count = $sent_count + $viewed_count + $partial_count; $overdue_query = ''; @@ -98,10 +101,13 @@ $sql = mysqli_query( invoice_amount, invoice_created_at, invoice_currency_code, invoice_date, invoice_discount_amount, invoice_due, invoice_id, invoice_number, invoice_prefix, invoice_scope, invoice_status, recurring_invoice_id, recurring_invoice_number, - recurring_invoice_prefix FROM invoices + recurring_invoice_prefix, IFNULL(invoice_payments.amount_paid, 0) AS amount_paid FROM invoices LEFT JOIN clients ON invoice_client_id = client_id LEFT JOIN categories ON invoice_category_id = category_id LEFT JOIN recurring_invoices ON invoice_recurring_invoice_id = recurring_invoice_id + LEFT JOIN (SELECT payment_invoice_id, SUM(payment_amount) AS amount_paid + FROM payments + GROUP BY payment_invoice_id) AS invoice_payments ON payment_invoice_id = invoice_id WHERE ($status_query) $overdue_query $category_query @@ -339,6 +345,8 @@ $num_rows = mysqli_fetch_row(mysqli_query($mysqli, "SELECT FOUND_ROWS()")); $invoice_due = escapeHtml($row['invoice_due']); $invoice_discount = floatval($row['invoice_discount_amount']); $invoice_amount = floatval($row['invoice_amount']); + $amount_paid = floatval($row['amount_paid']); + $invoice_balance = $invoice_amount - $amount_paid; $invoice_currency_code = escapeHtml($row['invoice_currency_code']); $invoice_created_at = escapeHtml($row['invoice_created_at']); $client_id = intval($row['client_id']); @@ -395,7 +403,12 @@ $num_rows = mysqli_fetch_row(mysqli_query($mysqli, "SELECT FOUND_ROWS()")); - + + + 0 && $invoice_balance > 0) { ?> +
due + + diff --git a/agent/modals/client/client_bulk_add_ticket.php b/agent/modals/client/client_bulk_add_ticket.php index 8c65a86d6..c9e763deb 100644 --- a/agent/modals/client/client_bulk_add_ticket.php +++ b/agent/modals/client/client_bulk_add_ticket.php @@ -86,12 +86,12 @@ ob_start(); $sql = mysqli_query( $mysqli, "SELECT user_id, user_name FROM users - WHERE user_role_id > 1 AND user_status = 1 AND user_archived_at IS NULL ORDER BY user_name ASC" + WHERE user_type = 1 AND user_status = 1 AND user_archived_at IS NULL ORDER BY user_name ASC" ); while ($row = mysqli_fetch_assoc($sql)) { $user_id = intval($row['user_id']); $user_name = escapeHtml($row['user_name']); ?> - + diff --git a/agent/modals/ticket/ticket_add.php b/agent/modals/ticket/ticket_add.php index d3c8627a6..f6cfe4206 100644 --- a/agent/modals/ticket/ticket_add.php +++ b/agent/modals/ticket/ticket_add.php @@ -161,7 +161,7 @@ ob_start(); while ($row = mysqli_fetch_assoc($sql)) { $user_id = intval($row['user_id']); $user_name = escapeHtml($row['user_name']); ?> - + diff --git a/agent/post/recurring_ticket.php b/agent/post/recurring_ticket.php index 115b663ec..ce10b9d1e 100644 --- a/agent/post/recurring_ticket.php +++ b/agent/post/recurring_ticket.php @@ -192,7 +192,8 @@ if (isset($_POST['bulk_force_recurring_tickets'])) { $email_subject = "Ticket Created - [$ticket_prefix$ticket_number] - $ticket_subject (scheduled)"; // SLA response commitment for this client + priority, empty when no SLA applies $sla_notice = escapeSql(getTicketSlaEmailNotice($id, $company_phone)); - $email_body = "##- Please type your reply above this line -##

Hello $contact_name,

A ticket regarding \"$ticket_subject\" has been automatically created for you.

--------------------------------
$ticket_details--------------------------------

Ticket: $ticket_prefix$ticket_number
Subject: $ticket_subject
Status: Open
Portal: https://$config_base_url/client/ticket.php?id=$id$sla_notice

--
$company_name - Support
$config_ticket_from_email
$company_phone"; + $ticket_status_name = escapeSql(getTicketStatusName($ticket_status)); + $email_body = "##- Please type your reply above this line -##

Hello $contact_name,

A ticket regarding \"$ticket_subject\" has been automatically created for you.

--------------------------------
$ticket_details--------------------------------

Ticket: $ticket_prefix$ticket_number
Subject: $ticket_subject
Status: $ticket_status_name
Portal: https://$config_base_url/client/ticket.php?id=$id$sla_notice

--
$company_name - Support
$config_ticket_from_email
$company_phone"; $email = [ 'from' => $config_ticket_from_email, @@ -341,7 +342,8 @@ if (isset($_GET['force_recurring_ticket'])) { $email_subject = "Ticket created - [$ticket_prefix$ticket_number] - $ticket_subject (scheduled)"; // SLA response commitment for this client + priority, empty when no SLA applies $sla_notice = escapeSql(getTicketSlaEmailNotice($id, $company_phone)); - $email_body = "##- Please type your reply above this line -##

Hello $contact_name,

A ticket regarding \"$ticket_subject\" has been automatically created for you.

--------------------------------
$ticket_details--------------------------------

Ticket: $ticket_prefix$ticket_number
Subject: $ticket_subject
Status: Open
Portal: https://$config_base_url/client/ticket.php?id=$id$sla_notice

--
$company_name - Support
$config_ticket_from_email
$company_phone"; + $ticket_status_name = escapeSql(getTicketStatusName($ticket_status)); + $email_body = "##- Please type your reply above this line -##

Hello $contact_name,

A ticket regarding \"$ticket_subject\" has been automatically created for you.

--------------------------------
$ticket_details--------------------------------

Ticket: $ticket_prefix$ticket_number
Subject: $ticket_subject
Status: $ticket_status_name
Portal: https://$config_base_url/client/ticket.php?id=$id$sla_notice

--
$company_name - Support
$config_ticket_from_email
$company_phone"; $email = [ 'from' => $config_ticket_from_email, diff --git a/agent/post/ticket.php b/agent/post/ticket.php index e573b303e..8ab725133 100644 --- a/agent/post/ticket.php +++ b/agent/post/ticket.php @@ -142,7 +142,7 @@ if (isset($_POST['add_ticket'])) { $subject = "Ticket Created [$ticket_prefix$ticket_number] - $ticket_subject"; // SLA response commitment for this client + priority, empty when no SLA applies $sla_notice = escapeSql(getTicketSlaEmailNotice($ticket_id, $company_phone)); - $body = "##- Please type your reply above this line -##

Hello $contact_name,

A ticket regarding \"$ticket_subject\" has been created for you.

--------------------------------
$ticket_details--------------------------------

Ticket: $ticket_prefix$ticket_number
Subject: $ticket_subject
Status: Open
Portal: View ticket$sla_notice

--
$company_name - Support
$config_ticket_from_email
$company_phone"; + $body = "##- Please type your reply above this line -##

Hello $contact_name,

A ticket regarding \"$ticket_subject\" has been created for you.

--------------------------------
$ticket_details--------------------------------

Ticket: $ticket_prefix$ticket_number
Subject: $ticket_subject
Status: $ticket_status_name
Portal: View ticket$sla_notice

--
$company_name - Support
$config_ticket_from_email
$company_phone"; // Verify contact email is valid if (filter_var($contact_email, FILTER_VALIDATE_EMAIL)) { diff --git a/agent/quote.php b/agent/quote.php index 6b008a83a..4aff7960a 100644 --- a/agent/quote.php +++ b/agent/quote.php @@ -128,14 +128,7 @@ if (isset($_GET['quote_id'])) { } //Product autocomplete - $products_sql = mysqli_query($mysqli, "SELECT product_name AS label, product_description AS description, product_price AS price, product_tax_id AS tax FROM products WHERE product_archived_at IS NULL"); - - if (mysqli_num_rows($products_sql) > 0) { - while ($row = mysqli_fetch_assoc($products_sql)) { - $products[] = $row; - } - $json_products = json_encode($products); - } + $json_products = getProductsForAutocomplete($mysqli); // Quote File Attachments $sql_quote_files = mysqli_query( @@ -403,6 +396,7 @@ if (isset($_GET['quote_id'])) {
+ - - + + diff --git a/agent/recurring_invoice.php b/agent/recurring_invoice.php index 2db896fbb..5d3232541 100644 --- a/agent/recurring_invoice.php +++ b/agent/recurring_invoice.php @@ -117,14 +117,7 @@ if (isset($_GET['recurring_invoice_id'])) { $sql_history = mysqli_query($mysqli, "SELECT history_created_at, history_description, history_status FROM history WHERE history_recurring_invoice_id = $recurring_invoice_id ORDER BY history_id DESC"); //Product autocomplete - $products_sql = mysqli_query($mysqli, "SELECT product_name AS label, product_description AS description, product_price AS price, product_tax_id AS tax FROM products WHERE product_archived_at IS NULL"); - - if (mysqli_num_rows($products_sql) > 0) { - while ($row = mysqli_fetch_assoc($products_sql)) { - $products[] = $row; - } - $json_products = json_encode($products); - } + $json_products = getProductsForAutocomplete($mysqli); enforceClientAccess(); @@ -340,6 +333,7 @@ if (isset($_GET['recurring_invoice_id'])) { + - - + + diff --git a/agent/reports/tax_summary.php b/agent/reports/tax_summary.php index 86a302814..5be9f825a 100644 --- a/agent/reports/tax_summary.php +++ b/agent/reports/tax_summary.php @@ -86,21 +86,19 @@ $sql_tax = mysqli_query($mysqli, "SELECT `tax_name` FROM `taxes`"); if ($view == 'monthly') { + // Row total = sum of this tax’s 12 months, accumulated as we go + $row_total = 0.0; for ($i = 1; $i <= 12; $i++) { $monthly_tax = (float) getMonthlyTax($tax_name, $i, $year, $mysqli); // Accumulate totals $monthly_totals[$i] += $monthly_tax; $grand_total += $monthly_tax; + $row_total += $monthly_tax; echo "" . numfmt_format_currency($currency_format, $monthly_tax, $company_currency) . ""; } - // Row total = sum of this tax’s 12 months - $row_total = 0.0; - for ($i = 1; $i <= 12; $i++) { - $row_total += (float) getMonthlyTax($tax_name, $i, $year, $mysqli); - } echo "" . numfmt_format_currency($currency_format, $row_total, $company_currency) . ""; } else { diff --git a/api/v1/credentials/archive.php b/api/v1/credentials/archive.php new file mode 100644 index 000000000..a607bf0e9 --- /dev/null +++ b/api/v1/credentials/archive.php @@ -0,0 +1,44 @@ + 0) { + $ticket_status = 2; // Set to open if we've auto-assigned an agent + } + // Atomically increment and get the new ticket number mysqli_query($mysqli, " UPDATE settings @@ -45,7 +50,7 @@ if (!empty($subject)) { // Insert ticket $url_key = randomString(32); - $insert_sql = mysqli_query($mysqli,"INSERT INTO tickets SET ticket_prefix = '$config_ticket_prefix', ticket_number = $ticket_number, ticket_source = 'API', ticket_subject = '$subject', ticket_details = '$details', ticket_priority = '$priority', ticket_status = 1, ticket_billable = $billable, ticket_vendor_ticket_number = '$vendor_ticket_number', ticket_vendor_id = $vendor_id, ticket_created_by = 0, ticket_assigned_to = $assigned_to, ticket_contact_id = $contact, ticket_asset_id = $asset, ticket_url_key = '$url_key', ticket_client_id = $client_id"); + $insert_sql = mysqli_query($mysqli,"INSERT INTO tickets SET ticket_prefix = '$config_ticket_prefix', ticket_number = $ticket_number, ticket_source = 'API', ticket_subject = '$subject', ticket_details = '$details', ticket_priority = '$priority', ticket_status = $ticket_status, ticket_billable = $billable, ticket_vendor_ticket_number = '$vendor_ticket_number', ticket_vendor_id = $vendor_id, ticket_created_by = 0, ticket_assigned_to = $assigned_to, ticket_contact_id = $contact, ticket_asset_id = $asset, ticket_url_key = '$url_key', ticket_client_id = $client_id"); // Check insert & get insert ID if ($insert_sql) { diff --git a/api/v1/tickets/update.php b/api/v1/tickets/update.php new file mode 100644 index 000000000..63ffd895f --- /dev/null +++ b/api/v1/tickets/update.php @@ -0,0 +1,38 @@ + 0) { $email_subject = "Ticket created - [$ticket_prefix$ticket_number] - $ticket_subject (scheduled)"; // SLA response commitment for this client + priority, empty when no SLA applies $sla_notice = escapeSql(getTicketSlaEmailNotice($id, $company_phone)); - $email_body = "##- Please type your reply above this line -##

Hello $contact_name,

A ticket regarding \"$ticket_subject\" has been automatically created for you.

--------------------------------
$ticket_details--------------------------------

Ticket: $ticket_prefix$ticket_number
Subject: $ticket_subject
Status: Open
Portal: https://$config_base_url/client/ticket.php?id=$id$sla_notice

--
$company_name - Support
$config_ticket_from_email
$company_phone"; + $ticket_status_name = escapeSql(getTicketStatusName($ticket_status)); + $email_body = "##- Please type your reply above this line -##

Hello $contact_name,

A ticket regarding \"$ticket_subject\" has been automatically created for you.

--------------------------------
$ticket_details--------------------------------

Ticket: $ticket_prefix$ticket_number
Subject: $ticket_subject
Status: $ticket_status_name
Portal: https://$config_base_url/client/ticket.php?id=$id$sla_notice

--
$company_name - Support
$config_ticket_from_email
$company_phone"; $email = [ 'from' => $config_ticket_from_email, diff --git a/functions/app.php b/functions/app.php index 0b4af1597..36dba407e 100644 --- a/functions/app.php +++ b/functions/app.php @@ -644,12 +644,20 @@ function checkForUpdates() { } function getMonthlyTax($tax_name, $month, $year, $mysqli) { - // SQL to calculate monthly tax - $sql = "SELECT SUM(item_tax) AS monthly_tax FROM invoice_items - LEFT JOIN invoices ON invoice_items.item_invoice_id = invoices.invoice_id - LEFT JOIN payments ON invoices.invoice_id = payments.payment_invoice_id + // Cash basis - tax is booked to the month the money arrived, in proportion to + // how much of the invoice that payment covered. Driving off payments (rather + // than invoice_items) counts each payment exactly once, and pre-aggregating + // the line items stops a multi-payment invoice multiplying its own tax. + $sql = "SELECT SUM(invoice_tax.tax_total * (payments.payment_amount / invoices.invoice_amount)) AS monthly_tax + FROM payments + INNER JOIN invoices ON invoices.invoice_id = payments.payment_invoice_id + INNER JOIN (SELECT item_invoice_id, SUM(item_tax) AS tax_total + FROM invoice_items + WHERE item_tax_id = (SELECT tax_id FROM taxes WHERE tax_name = '$tax_name') + GROUP BY item_invoice_id) AS invoice_tax + ON invoice_tax.item_invoice_id = invoices.invoice_id WHERE YEAR(payments.payment_date) = $year AND MONTH(payments.payment_date) = $month - AND invoice_items.item_tax_id = (SELECT tax_id FROM taxes WHERE tax_name = '$tax_name')"; + AND invoices.invoice_amount > 0"; $result = mysqli_query($mysqli, $sql); $row = mysqli_fetch_assoc($result); return $row['monthly_tax'] ?? 0; @@ -660,12 +668,17 @@ function getQuarterlyTax($tax_name, $quarter, $year, $mysqli) { $start_month = ($quarter - 1) * 3 + 1; $end_month = $start_month + 2; - // SQL to calculate quarterly tax - $sql = "SELECT SUM(item_tax) AS quarterly_tax FROM invoice_items - LEFT JOIN invoices ON invoice_items.item_invoice_id = invoices.invoice_id - LEFT JOIN payments ON invoices.invoice_id = payments.payment_invoice_id + // SQL to calculate quarterly tax - see getMonthlyTax for why it is shaped this way + $sql = "SELECT SUM(invoice_tax.tax_total * (payments.payment_amount / invoices.invoice_amount)) AS quarterly_tax + FROM payments + INNER JOIN invoices ON invoices.invoice_id = payments.payment_invoice_id + INNER JOIN (SELECT item_invoice_id, SUM(item_tax) AS tax_total + FROM invoice_items + WHERE item_tax_id = (SELECT tax_id FROM taxes WHERE tax_name = '$tax_name') + GROUP BY item_invoice_id) AS invoice_tax + ON invoice_tax.item_invoice_id = invoices.invoice_id WHERE YEAR(payments.payment_date) = $year AND MONTH(payments.payment_date) BETWEEN $start_month AND $end_month - AND invoice_items.item_tax_id = (SELECT tax_id FROM taxes WHERE tax_name = '$tax_name')"; + AND invoices.invoice_amount > 0"; $result = mysqli_query($mysqli, $sql); $row = mysqli_fetch_assoc($result); return $row['quarterly_tax'] ?? 0; @@ -858,3 +871,46 @@ function getSentMethods() { 'Other' ]; } + + +/* + * Products for the line-item autocomplete on invoices, quotes and recurring + * invoices. + * + * All three pages share js/product_autocomplete.js, so they must all be handed + * the same shape. They used to carry a SELECT each and they drifted: quote and + * recurring invoice only selected label/description/price/tax, so the shared + * onSelect wrote item.product_name - undefined - into the item name field. + * + * Returns a JSON string ready to emit into the page. + */ +function getProductsForAutocomplete($mysqli): string +{ + $products = []; + + $sql = mysqli_query($mysqli, " + SELECT + IF(product_code IS NULL OR product_code = '', product_name, CONCAT(product_code, ' - ', product_name)) AS label, + product_name, + product_code, + product_type AS type, + product_description AS description, + product_price AS price, + product_tax_id AS tax, + tax_percent, + product_id AS prod_id, + COALESCE(SUM(product_stock.stock_qty), 0) AS available_stock + FROM products + LEFT JOIN product_stock ON product_id = stock_product_id + LEFT JOIN taxes ON product_tax_id = tax_id + WHERE product_archived_at IS NULL + GROUP BY product_id + ORDER BY product_name ASC + "); + + while ($row = mysqli_fetch_assoc($sql)) { + $products[] = $row; + } + + return json_encode($products) ?: '[]'; +} diff --git a/includes/app_version.php b/includes/app_version.php index 9599e5c68..8a73abb70 100644 --- a/includes/app_version.php +++ b/includes/app_version.php @@ -5,4 +5,4 @@ * Update this file each time we merge develop into master. Format is YY.MM (add a .v if there is more than one release a month. */ -DEFINE("APP_VERSION", "26.09.2"); +DEFINE("APP_VERSION", "26.09.3"); diff --git a/js/product_autocomplete.js b/js/product_autocomplete.js new file mode 100644 index 000000000..b054a2dde --- /dev/null +++ b/js/product_autocomplete.js @@ -0,0 +1,76 @@ +/* + * Product autocomplete for the add-item row on invoices, quotes and recurring + * invoices. + * + * The three pages used to carry a copy of this each, and they drifted - the + * quote and recurring invoice copies were fed a four column product query, so + * item.product_name was undefined and selecting a product wrote the literal + * string "undefined" into the item name. + * + * Call with the array emitted by getProductsForAutocomplete(): + * + * initProductAutocomplete(); + */ +function initProductAutocomplete(availableProducts) { + + var nameInput = document.getElementById('name'); + if (!nameInput) { + return; + } + + // Quote and recurring invoice do not store the product link yet, so treat + // the hidden input as optional rather than throwing on every keystroke. + var productIdInput = document.getElementById('product_id'); + + itflowAutocomplete(nameInput, { + minLength: 1, + source: availableProducts || [], + match: function (item, term) { + return String(item.label || '').toLowerCase().indexOf(term) !== -1 + || String(item.product_name || '').toLowerCase().indexOf(term) !== -1 + || String(item.product_code || '').toLowerCase().indexOf(term) !== -1; + }, + render: function (item) { + var esc = itflowEscapeHtml; + var typeText = item.type ? item.type.charAt(0).toUpperCase() + item.type.slice(1).toLowerCase() : ""; + var showStock = (typeText.toLowerCase() !== "service"); + var taxText = (item.tax_percent != null) ? (parseFloat(item.tax_percent) + "%") : "No tax"; + var priceText = (item.price != null && item.price !== "") ? String(item.price) : ""; + var stockText = (item.available_stock ?? 0); + + return "
" + + "
" + + "
" + esc(item.label) + + (typeText ? " (" + esc(typeText) + ")" : "") + + "
" + + "
" + esc(item.description) + "
" + + "
" + + "Tax: " + esc(taxText) + "" + + (showStock ? "Stock: " + esc(stockText) + "" : "") + + "
" + + "
" + + "
" + + "
" + esc(priceText) + "
" + + "
" + + "
"; + }, + onSelect: function (item) { + nameInput.value = item.product_name; + document.getElementById('desc').value = item.description; + document.getElementById('qty').value = 1; + document.getElementById('price').value = item.price; + setTomSelectValue(document.getElementById('tax'), item.tax); + if (productIdInput) { + productIdInput.value = item.prod_id; + } + } + }); + + // Typing over the name by hand breaks the link to the product + if (productIdInput) { + nameInput.addEventListener('input', function () { + productIdInput.value = 0; + }); + } + +}