# Time Tracking and Invoicing

Track your hours with timers or by hand, check your time card, and turn unbilled time into invoices in your own design.

Hours that never get written down never get billed. At Acme Precision, the engineers run a timer for each customer job, and at month end the office manager turns the unbilled hours into invoices in a few clicks.

[Add it from the Marketplace](/tenant/?open=settings/marketplace)

## What it does

Each person sees only the tabs their role allows.

- **Track**: start a timer, or add time you already worked under **Manual**. **Active timers** lists your running timers.
- **Time postings**: the **Log** of your entries, and a printable **Time card** by **Day**, **Week** or **Month**.
- **Activity report**: asks Claude to rebuild time you forgot to enter, as drafts you review and post.
- **Customers**: customers, their projects and hourly rates.
- **Status videos**: send a customer short progress videos, with one link and a 4-digit code.
- **Invoices**: generate invoices from unbilled time, then view, mark paid or void them.
- **Invoice Designer**: build your invoice's look from a sample invoice you already send.
- **Settings**: your **Business details**, printed on every invoice.

## Set it up

1. Open **Module Settings** from the ⋮ on the module's sidebar row. Set the time zone, whether billed time is rounded up and, if you share status videos, the status website's address (**updates_site_url**). See [Module settings and versions](article:fb7c92e4-6dcc-4ef4-80bc-1b6e7482e540).
2. Give each role its access (see [Users and roles: create and edit roles](article:88d4e232-d5b8-4909-b452-cfe96d3d550f)): everyone who logs hours needs **Open Time Tracking** and **Track their own time**. Give **View everyone's time and dollars** and **Create and send invoices** only to the people who bill.
3. Open **Settings**, fill in **Business details** (at least **Company name** and **Invoice # prefix**), and click **Save**. Invoices can't be generated until this is done.
4. Open **Customers**, click **Add customer**, type the **Name** and **Hourly rate**, and click **Add**. Repeat for each customer.
5. Click **Projects** on a customer to add its projects, with an optional **Rate override**. Untick **Billable** for internal work.
6. Click **Edit** on a customer to add the billing details printed on invoices (**Contact (Attn:)**, **Email**, **Phone**, **Address**). Pick its **Documentation project**, where invoice notes, status videos and other reporting work go. Under **People & rates**, give one person their own rate for this customer.
7. Optional: open **Invoice Designer** to match your current invoice (see below).
8. Optional: for automatic activity reports, each person adds **Claude activity** in the Bridge Harness on their PC (**Connectors** › **Available to add**) and signs in to Claude Code there.

## Track your time

1. Open **Track** and choose **Timer**.
2. Pick the **Customer** and, if it has one, the **Project**.
3. Type **What are you working on?**
4. Forgot to start on time? Set **Started at**, or click **−15m**, **−30m** or **−60m**.
5. Click **Start timer**.

Your timer shows under **Active timers**, with **Pause**, **Resume**, **Note** and **Stop**. **Stop** saves it as a time entry, and the **×** discards it. You can run several at once.

For work that's already done, choose **Manual**, set the **Date**, **Start** and **End**, and click **Save entry**.

To check your time, open **Time postings**. In the **Log**, click **Edit** on an entry to change it, **×** to remove it, or the play button to start a timer on the same task again. An entry on an invoice shows *locked*. Filter by **Customer**, **From**, **To** and **Unbilled only**, then click **Filter**. **Export CSV** saves the list as a spreadsheet. **Time card** shows your posted time by **Day**, **Week** or **Month**.

## Rebuild time you forgot to enter

1. Open **Activity report** and keep **Request** selected.
2. Set **From** and **To**, or click **Yesterday** or **Since my last report**.
3. Read **How Claude runs it**. With the **Claude activity** connector set up on your PC, it runs there by itself. Otherwise it opens Claude Code in the Claude app, and you press Send there.
4. Click **Check Claude for Activity Report**, or **Copy prompt** to paste it into Claude yourself.
5. When the report is back, open it under **Recent reports**. **What Claude checked** shows which sources Claude could read. Tick the rows that are right and click **Post time**, or click **Edit and post** to check each row first.
6. Or open **Review** to **Approve** or **Skip** the drafts day by day. **Approve all waiting** approves every day.

Your Time Tracking entries are always included, so nothing is counted twice. **Delete report** removes a report; time already posted from it stays.

## Make an invoice

1. Open **Invoices**. The **Generate invoice** form is at the top.
2. Pick the **Customer**. Leave **From** and **To** blank to bill all unbilled time.
3. Choose the **Lines**: **Design default**, **One per entry**, **One per day** or **One per project**.
4. Check the preview line, then click **Generate invoice**.

In the list, **View PDF** shows exactly what your customer gets. **Mark paid** records payment, and **Unpay** undoes it. **Void** cancels the invoice and releases its time back to unbilled. A voided invoice can't be marked paid.

## Design your invoice

1. Open **Invoice Designer** and click **New**.
2. Drop in a photo, scan or PDF of an invoice you already send, and click **Analyze**.
3. Click any label to retype it, or type a request such as "make the accent navy".
4. Check **View PDF**, then click **Set as default**.

## Share a status video

1. Open **Status videos**.
2. Under **Add a status video**, pick the **Customer** and set the **Date**, **Length**, **Title** and a one-line **Overview**.
3. Choose the **Video file (MP4, MOV or WebM)** and click **Upload**. To upload now and share later, untick **Visible to the customer**.
4. In the **Status videos** list, click **Share**. It shows the link, the code and a message to send (**Copy message**, **Copy link**, **Email**, **Open**).

A customer's link and 4-digit code are made with their first video, and one code opens all of their videos. Under **Customer links and codes**, **Edit** changes the link name, whether the link works, and the colours and logo of their pages. **New code** replaces the code and signs everyone out until they type the new one. **Share** needs the status website's address in the module's settings.

## Who can do what

Each action in the module needs a permission. A Workspace Admin gives permissions to roles; see [Users and roles: create and edit roles](article:88d4e232-d5b8-4909-b452-cfe96d3d550f). **Out of the box** shows the module's starting roles that have it.

| Permission | What it lets someone do | Out of the box |
|---|---|---|
| **Open Time Tracking** | Open the module and see their own timers and time entries and the customer and project names. | Admin, Operator, Viewer |
| **Track their own time** | Start, pause, stop and discard their own timers, add, edit and delete their own time entries, and use the activity report (opens the Activity report tab). | Admin, Operator |
| **Manage customers and rates** | Add and edit customers, projects, billing details and hourly rates, including per-person rates, delete customers, and upload and share status videos (opens the Customers and Status videos tabs). **Give with care.** | Admin |
| **View everyone's time and dollars** | See everyone's timers and entries, rates, dollar amounts, billing reports and invoices, and move an entry to another person (opens the Invoices tab and the Unbilled and Open invoices tiles). **Give with care.** | Admin |
| **Create and send invoices** | Generate invoices, void them and mark them paid or unpaid (also needs View everyone's time and dollars). **Give with care.** | Admin |
| **Design invoices** | Edit the business details and logo, and create and edit invoice designs (also opens the Settings tab). | Admin |
| **Website: status video viewer** | Machine permission for the status-updates website's API key only: read each customer's published status videos and check its access code. Never give it to a person or a role. **Give with care.** | Admin |

## Ask its agent

The **Billing Assistant** works with your access and no more. See [Agent chat](article:073c6465-d85c-4364-8768-acf42a3a6a48). Try:

- "Start a timer for Bluefield Aerospace, fixture design review."
- "Log 45 minutes for Northwind Logistics yesterday afternoon: sprint planning."
- "Show me unbilled time for Lakeshore Medical Devices this month."
- "Create an invoice for Northwind Logistics for September."

Before it creates an invoice, it shows the period, entries, hours and total, and waits for your yes.

## Good to know

- **An invoiced entry is locked.** To change it, ask whoever bills to **Void** the invoice first.
- **Invoices keep their rates.** Changing a rate later doesn't change an invoice. Void it and generate it again.
- **Which rate applies:** the person's own rate for that customer, else the project's **Rate override**, else the customer's **Hourly rate**.
- **No dollar amounts?** Without **View everyone's time and dollars**, you see hours only.
- **Generate invoice greyed out?** The **Business details** in **Settings** aren't filled in yet.

## More help

Open the module's **Help** (top right) for the full reference and its 12 **Runbooks**, from setting up your business details to sharing a status video (see [Find and follow a runbook](article:4b62ad1f-577a-4998-8bce-f00226376522)). Time Tracking datasets can be charted on a dashboard; see [Dashboard](article:1d8a33a4-3a13-4874-b8e5-5ef9da22df95). Who sees which tabs is set by roles; see [Users and roles: roles and permissions](article:888a2a90-7990-4ea5-a58e-af06f56b1bfd).


Source: https://datavisions.ai/docs/module-guides/time-tracking-and-invoicing
