Billable time (Coming Soon)

Billable time is time you charge to a customer. In TreeCraft, you mark a worklog as billable, and the app counts the marked time for you: on My timesheet, in the time report, in a Logged work column, in exports, and as the time an invoice is made from.

What a mark is

A mark is a note on the Jira worklog. It changes no hours and no estimate. A worklog with the mark shows as billable. A worklog without it is not billable.

The mark lives on the worklog in Jira, so anyone who may see that worklog in Jira may see the mark, and it goes away with the worklog. The app stores nothing about it. You can mark and unmark only your own worklogs, and only where Jira lets you change them.

The Billable switch

The Billable switch is in the toolbar of My timesheet. It is off by default, and the app remembers your choice for you on this site.

Off, nothing changes: no marks are shown and nothing more is read.

On, the page reads the marks of each work item that holds your time in the period shown, once more. A busy period takes a little longer to open. Then:

• A cell whose time is all billable shows ●, and a cell where only part of it is billable shows ◐. A screen reader hears Billable or Partly billable.
• A Billable row, under the total, shows the billable time of each day and of the week or the month. It counts only the marked time. In a cell that mixes marked and unmarked time, it counts the marked part.
• If the marks of a work item can't be read, its time still shows, but its days in the Billable row show a long dash instead of a time, and so does the total, with a line that says how many work items couldn't be read. The page never shows a total as complete when it isn't.

Marking time

Open the cell's list of worklogs: Shift+Enter in the cell, or the ... beside it. Each of your worklogs there has a Billable box. Tick it to mark the worklog, and clear it to take the mark off. Only the mark changes, never the time or the comment. If Jira refuses, the cell shows why and the box goes back to what Jira holds.

Undo takes back a mark.

New time is billable

Beside the Billable switch, while it is on, a second switch says New time is billable. It is off by default, and the app remembers it too. With it on, time you log in a cell, or from its list, is marked billable right after it is logged. Time copied with Copy last week is marked too.

If the mark fails, the time stays logged, unmarked, and the cell says so. Undo of such a write deletes the worklog, and its mark with it. Undo of a delete logs the time again and puts the mark back.

Where billable time shows

• My timesheet. The marks, the Billable row, and a Billable column in the export, with yes or no for each worklog.
• The Logged work column. In the grid, the Logged work column has a Billable only: work logs marked billable choice. The column then counts only the marked worklogs. Each work item with time in the period is read once more, for its marks.
• The time report. The Billable, Not billable and Not known columns, the Billable only filter, and a Billable column in the CSV.
• Invoices. An invoice is made from billable time only.
• The team view shows no billable time.

Turning billable time off for the site

Some sites don't bill time. An app admin can turn billable time off for everyone: in App settings, open Defaults, and under Billable time, clear Let people mark their time billable.

While it is off:

• Nobody on the site sees or marks billable time. There is no Billable switch on My timesheet, no New time is billable, no Billable row, and no Billable column in exports.
• A Logged work column set to Billable only shows a long dash instead of a time, and keeps its choice.
• The time report has no billable columns and no Billable only filter.
• Only the app's admins reach Invoices.

Nothing already marked is lost. The marks stay on the Jira worklogs as they were, and each person's own switches are kept. When you turn billable time on again, everything comes back. A page that is open learns of the change when it is loaded again.

Questions about the app? Ask us in Plugincraft Support, our help center, or write to info@plugincraft.ca.