Files
itflow/agent/reports/tickets_unbilled.php
johnnyq 1e5bffff3c Rates, net terms and SLAs come from the client's contract, else the instance defaults: database 3.5.0 adds a default after-hours rate (Settings > Defaults, now Rates and terms), gives each client whose own rate, net terms or SLAs differ from the defaults an active Standard terms contract setting just those (12-month term renewing itself, starting the day the client was added or the day before its earliest contract, archived with an archived client), deletes per-client SLA assignments and drops clients.client_rate and client_net_terms; time bills at the contract's rate, its after-hours rate or the default after-hours rate, else the default rate, new invoices are due on the contract's net terms else the default, and new tickets get the contract's SLA else the default; a client's own terms still apply until the update runs; the client add and edit windows lose the rate, terms and SLA fields for a note saying what the client is billed on and where it comes from, the Clients list loses Set Hourly Rate and Set Net Terms and shows the contract's rate, the overview's Terms shows the after-hours rate and whether terms are a contract's or the defaults, a contract's page and document show what it leaves empty from another contract in force or the default so signed documents stay unchanged, contract windows show the defaults as placeholders, contract names take a proper possessive; the client import and API create make a Standard terms contract for a rate or terms that aren't the defaults (returning contract_id), API update reports them in not_kept; the client export gives the rates, terms and SLAs as billed; demo data puts each demo client's terms on a contract; changelog updated
2026-10-27 22:22:34 -04:00

174 lines
10 KiB
PHP

<?php
/*
* Unbilled Work - billable tickets that are resolved or closed but on no
* invoice yet: money left on the table. Each ticket's time is rounded the
* way Admin > Settings > Invoice says and priced at the rate its client's
* contract sets, else the default rate - the same hours and rate Unbilled Time and a ticket's Invoice window fill
* in - so the value here is what invoicing them would come to. Per client,
* then every ticket, the longest waiting first.
*/
require_once "includes/inc_report.php";
reportEnforce('tickets_unbilled');
$client_id = reportClientId();
// The same tickets, hours and rates Unbilled Time bills - functions/billing.php
$time_rules = billingTimeRules();
$tickets = [];
foreach (billingUnbilledTickets($client_id) as $row) {
$row['billable_hours'] = $row['hours'];
$tickets[] = $row;
}
usort($tickets, function ($a, $b) {
return $b['waiting'] <=> $a['waiting'] ?: intval($a['ticket_number']) <=> intval($b['ticket_number']);
});
$clients = [];
foreach ($tickets as $ticket) {
$id = intval($ticket['ticket_client_id']);
$clients[$id] = $clients[$id] ?? ['client_id' => $id, 'client' => $ticket['client_name'], 'abbr' => $ticket['client_abbreviation'], 'rate' => $ticket['rate'],
'default_rate' => $ticket['default_rate'], 'rate_source' => $ticket['rate_source'] ?? '', 'rate_note' => $ticket['rate_note'] ?? '', 'rates' => [], 'tickets' => 0, 'seconds' => 0, 'billable_hours' => 0.0, 'value' => 0.0, 'oldest' => 0, 'no_time' => 0];
$clients[$id]['tickets']++;
$clients[$id]['rates'][sprintf('%.2f', $ticket['rate'])] = true;
$clients[$id]['seconds'] += $ticket['seconds'];
$clients[$id]['billable_hours'] += $ticket['billable_hours'];
$clients[$id]['value'] += $ticket['value'];
$clients[$id]['oldest'] = max($clients[$id]['oldest'], $ticket['waiting']);
$clients[$id]['no_time'] += $ticket['billable_hours'] <= 0 ? 1 : 0;
}
uasort($clients, function ($a, $b) { return $b['value'] <=> $a['value'] ?: $b['tickets'] <=> $a['tickets']; });
$clients = array_values($clients);
$waiting_html = function ($days) {
$tone = $days > 30 ? 'danger' : ($days > 7 ? 'warning' : 'secondary');
return '<span class="badge rounded-pill bg-' . $tone . '-subtle text-' . $tone . '-emphasis border border-' . $tone . '-subtle fw-normal">'
. ($days <= 0 ? 'Today' : $days . ' day' . ($days === 1 ? '' : 's')) . '</span>';
};
$rate_html = function ($row) {
// A client's tickets at more than one rate - a contract's after-hours rate, or work either side of a contract's start
if (count($row['rates'] ?? []) > 1) {
return '<span class="small" title="Each ticket bills at its own rate">Varies</span>';
}
if ($row['rate'] <= 0) {
return '<span class="text-warning-emphasis small" title="Give the client\'s contract an hourly rate, or set a default in Admin > Settings > Defaults">No rate</span>';
}
$source = $row['rate_source'] ?? '';
return reportMoney($row['rate']) . ($row['default_rate'] ? ' <span class="small text-body-tertiary" title="No contract in force sets a rate - this is the default hourly rate">default</span>'
: (in_array($source, ['contract', 'after_hours', 'default_after_hours'], true) ? ' <span class="small text-body-tertiary" title="' . escapeHtml(ucfirst((string) $row['rate_note'])) . '">' . ($source === 'contract' ? 'contract' : 'after hours') . '</span>' : ''));
};
$client_columns = [
'client' => ['label' => 'Client', 'html' => function ($row) {
return reportClientCell($row['client_id'], $row['client'], $row['abbr']);
}],
'tickets' => ['label' => 'Tickets', 'type' => 'count', 'html' => function ($row) {
return '<a class="itflow-report-amount" href="/agent/unbilled_time.php?client_id=' . $row['client_id'] . '">' . reportCount($row['tickets']) . '</a>'
. ($row['no_time'] ? ' <span class="small text-warning-emphasis" title="Tickets with too little time logged to bill">(' . $row['no_time'] . ' with no time)</span>' : '');
}],
'seconds' => ['label' => 'Time logged', 'type' => 'hours', 'decimals' => 2],
'billable_hours' => ['label' => 'To bill', 'type' => 'decimal', 'decimals' => 2, 'title' => 'Hours rounded ' . billingTimeRulesText($time_rules) . ', ticket by ticket'],
'rate' => ['label' => 'Rate', 'type' => 'money', 'html' => $rate_html],
'value' => ['label' => 'Value', 'type' => 'money', 'class' => 'fw-semibold'],
'oldest' => ['label' => 'Oldest waiting', 'type' => 'count', 'csv_label' => 'Oldest days waiting', 'html' => function ($row) use ($waiting_html) {
return $waiting_html($row['oldest']);
}],
];
$ticket_columns = [
'ticket' => ['label' => 'Ticket', 'csv' => function ($row) { return ticketReference($row) . ' ' . $row['ticket_subject']; }, 'html' => function ($row) {
return reportTicketLink($row);
}, 'class' => 'itflow-report-text'],
'client_name' => ['label' => 'Client', 'html' => function ($row) {
return reportClientCell($row['ticket_client_id'], $row['client_name'], $row['client_abbreviation']);
}],
'user_name' => ['label' => 'Agent', 'html' => function ($row) {
return reportAgentCell($row['ticket_assigned_to'], $row['user_name'] ?? '', $row['user_avatar'] ?? '');
}],
'resolved' => ['label' => 'Done', 'type' => 'date', 'class' => 'text-nowrap', 'csv' => function ($row) {
return substr($row['ticket_resolved_at'] ?: $row['ticket_closed_at'], 0, 10);
}, 'html' => function ($row) {
return escapeHtml(date('M j, Y', strtotime($row['ticket_resolved_at'] ?: $row['ticket_closed_at'])));
}],
'waiting' => ['label' => 'Waiting', 'type' => 'count', 'csv_label' => 'Days waiting', 'html' => function ($row) use ($waiting_html) {
return $waiting_html($row['waiting']);
}],
'seconds' => ['label' => 'Time logged', 'type' => 'hours', 'decimals' => 2, 'html' => function ($row) {
return $row['seconds'] <= 0 ? '<span class="text-warning-emphasis" title="No time logged on this ticket">None</span>' : reportHours($row['seconds'], 2);
}],
'billable_hours' => ['label' => 'To bill', 'type' => 'decimal', 'decimals' => 2],
'rate' => ['label' => 'Rate', 'type' => 'money', 'html' => $rate_html],
'value' => ['label' => 'Value', 'type' => 'money', 'class' => 'fw-semibold'],
];
foreach ($tickets as &$ticket) {
$ticket['resolved'] = $ticket['ticket_resolved_at'] ?: $ticket['ticket_closed_at'];
}
unset($ticket);
$totals = ['tickets' => count($tickets), 'seconds' => array_sum(array_column($tickets, 'seconds')),
'billable_hours' => array_sum(array_column($tickets, 'billable_hours')), 'value' => array_sum(array_column($tickets, 'value'))];
if (reportExporting('tickets')) {
reportCsv('Unbilled Tickets', $ticket_columns, $tickets, ['ticket' => 'Total'] + $totals);
}
if (reportExporting()) {
reportCsv('Unbilled Work by Client', $client_columns, $clients, ['client' => 'Total'] + $totals);
}
require_once "includes/inc_report_layout.php";
$no_time = count(array_filter($tickets, function ($t) { return $t['billable_hours'] <= 0; }));
$no_rate = count(array_filter($tickets, function ($t) { return $t['rate'] <= 0; }));
$over_30 = array_filter($tickets, function ($t) { return $t['waiting'] > 30; });
?>
<div class="itflow-report">
<?php reportHeader('tickets_unbilled', [
'client' => $client_id,
'subtitle' => 'As of ' . date('M j, Y'),
'export' => ['clients' => 'By client', 'tickets' => 'Every ticket'],
]); ?>
<?= reportStats([
['label' => 'Not invoiced yet', 'value' => reportMoney($totals['value']), 'tone' => $totals['value'] > 0 ? 'warning' : '',
'sub' => '<span class="text-body-tertiary">At each client\'s rate</span>'],
['label' => 'Tickets', 'value' => reportCount(count($tickets)), 'url' => '/agent/unbilled_time.php' . ($client_id ? "?client_id=$client_id" : ''),
'sub' => reportCount(count($clients)) . ' <span class="text-body-tertiary">client' . (count($clients) === 1 ? '' : 's') . '</span>'],
['label' => 'Hours to bill', 'value' => number_format($totals['billable_hours'], 2), 'sub' => escapeHtml(reportHours($totals['seconds'], 2)) . ' <span class="text-body-tertiary">logged</span>', 'title' => 'Each ticket\'s time rounded ' . billingTimeRulesText($time_rules)],
['label' => 'Waiting over 30 days', 'value' => reportCount(count($over_30)), 'tone' => $over_30 ? 'danger' : 'success',
'sub' => $over_30 ? escapeHtml(reportMoney(array_sum(array_column($over_30, 'value')))) . ' <span class="text-body-tertiary">of it</span>' : '<span class="text-body-tertiary">Nothing left that long</span>'],
]) ?>
<?php if ($no_time || $no_rate) { ?>
<div class="alert alert-warning d-flex gap-2 align-items-start">
<i class="fas fa-exclamation-triangle mt-1"></i>
<div>
<?php if ($no_time) { ?><div><?= $no_time ?> billable ticket<?= $no_time === 1 ? ' has' : 's have' ?> too little time logged to bill, so <?= $no_time === 1 ? 'it adds' : 'they add' ?> nothing here - log the time, type the hours in <a href="/agent/unbilled_time.php">Unbilled Time</a>, or mark <?= $no_time === 1 ? 'it' : 'them' ?> not billable there.</div><?php } ?>
<?php if ($no_rate) { ?><div><?= $no_rate ?> ticket<?= $no_rate === 1 ? ' is' : 's are' ?> for a client with no hourly rate - set one on the client, or a default hourly rate in Admin > Settings.</div><?php } ?>
</div>
</div>
<?php } ?>
<?= reportSectionOpen('By client', 'Most to bill first') ?>
<?= reportTable($client_columns, $clients, [
'empty' => reportEmpty('You are all caught up - every billable ticket that is done has been invoiced.'),
'totals' => ['client' => 'Total'] + $totals,
]) ?>
</div>
<?php if ($tickets) { ?>
<?= reportSectionOpen('Every ticket', 'Longest waiting first', 'itflow-report-long') ?>
<?= reportTable($ticket_columns, $tickets, ['limit' => 300, 'export_table' => 'tickets', 'totals' => ['ticket' => 'Total'] + $totals]) ?>
<div class="card-footer small text-body-secondary">
Billable tickets that are resolved or closed and on no invoice. Bill them in <a href="/agent/unbilled_time.php<?= $client_id ? "?client_id=$client_id" : '' ?>">Unbilled Time</a> - the hours and rates here are what it fills in.
</div>
</div>
<?php } ?>
</div>
<?php require_once "../../includes/footer.php"; ?>
<script src="/js/reports.js"></script>