Odoo Community
Odoo Enterprise
Every hour of support is recorded on the ticket it was spent on
For support teams that already track their work in projects and timesheets
The hours a ticket actually cost
Odoo 19.0 · Community and Enterprise · OPL-1
Extends Helpdesk Project Integration: the tickets it links to a project and a task gain a Timesheets tab.
What changes for your team
Time is logged on the ticket, while the work is fresh
Agents note their time somewhere else and fill in timesheets at the end of the week, against a catch-all task.
→ The ticket has a Timesheets tab. The agent adds the date, a description and the time spent; the project and the task come from the ticket, and the total shows under the list.
Project managers see the support hours on the task
A project's hours show the planned work; the time support spent on the same customer is missing.
→ A line logged on a ticket is also a line of the ticket's task, so the task and its project count the support hours with the rest of the work.
Support effort is reported like every other hour
What a customer's or a project's tickets cost in hours is an estimate kept outside the system.
→ Ticket lines sit in All Timesheets next to project work. Approvers group them by project and by ticket to see what each ticket took.
Ready on day one
Installs itself
Once Helpdesk Project Integration and Timesheets are both installed, this module is installed with them.
Your access rights as they are
The Timesheets access rights you already assign decide who logs time and who sees everyone's lines.
Followers log their time
An agent who follows a ticket logs time on it, even when its project is open only to the project's followers.
What you set up first
Timesheets on the projects that collect support hours, a default project for each support team, and the agents' Timesheets access.
What is included
The Timesheets tab of the ticket, lines linked to the ticket and to its project and task, the per-project switch, and time logging for ticket followers. Teams, stages and SLA policies come from Helpdesk; projects and tasks on tickets from Helpdesk Project Integration.
Optional extension
Agents start and stop a timer on the ticket, and the time becomes a timesheet line of that ticket.
Before you decide
Who sees which hours?
An agent with "own timesheets only" sees their own lines on a ticket. A user with "all timesheets" sees every employee's lines. Without a Timesheets access right, the tab does not appear.
Do we have to time every ticket?
No. Only tickets whose project accepts timesheets show the tab. Switching it off for a project hides the tab and keeps the lines already logged.
Does it invoice support time?
No. It records hours as timesheet lines; it creates no invoice.
We run several companies. Can hours cross between them?
No. A line must belong to the company of its ticket; any other company is refused.
Which languages does it ship?
English and Vietnamese.
Try it, then ask us
The Documentation tab walks through the setup and the work of each role, from the support agent to the timesheet approver, screen by screen.
Technical requirements
- Odoo version: 19.0
- Editions: Community, Enterprise
- Required modules: Helpdesk Project Integration, Timesheets (Task Logs)
- License: OPL-1
- Languages: English, Vietnamese
Helpdesk Timesheet Integration
Who this guide is for: support agents who log the time they spend on tickets, team leaders and timesheet approvers who follow that time, and the administrator who sets up the projects behind the support teams.
Note
Extends the Helpdesk Project Link - see the viin_helpdesk_project documentation for the project and the task of a ticket, and the viin_helpdesk documentation for tickets and support teams in general.
Overview
Solving a ticket takes time, and that time is worth measuring. This module adds a Timesheets tab to the ticket: the agent logs the hours there, and the same hours appear in the timesheets of the ticket's project and task. Support effort is therefore measured where the rest of the company's working time is measured, and it can be reported with the Timesheets and Project apps.
How the work flows:
- A ticket belongs to a project (the default project of its support team, or the one the agent chooses).
- The support agent works on the ticket and logs the time on its Timesheets tab.
- The hours show on the task of the ticket and in Timesheets under the project.
- The team leader or timesheet approver follows the hours per project, task and employee.
| Who |
What they do |
Access right to assign |
| Support agent |
Logs time on the tickets they work on and sees their own lines |
Helpdesk / User and Timesheets / User: own timesheets only |
| Team leader, timesheet approver |
Sees the lines of all employees on the tickets and reports on them |
Timesheets / User: all timesheets |
| Administrator |
Chooses which projects accept timesheets |
Project / Administrator |
Setup (for the administrator)
Installation
- Open Apps.
- Search for Helpdesk Timesheet Integration and press Install. The Helpdesk Project Link and the Timesheets app are required; they are installed with it if they are missing.
Let a project accept timesheets
The Timesheets tab of a ticket appears only when the ticket's project accepts timesheets.
- Open Project ‣ Projects and select the project. Project / Administrator is enough to do this.
- Open the Settings tab and tick Timesheets in the Time Management section.
- Save.
Unticking Timesheets hides the Timesheets tab of the tickets of that project; the lines already logged are kept.
To give the tickets of a support team a project by default, open Helpdesk ‣ Configuration ‣ Helpdesk Teams, select the team and choose the project in its Project tab (see the Helpdesk Project Link guide).
Assign the access rights
Open Settings ‣ Users & Companies ‣ Users, select the user and set Timesheets to User: own timesheets only (support agents) or User: all timesheets (team leaders and approvers). An agent also needs Helpdesk / User.
Support agent
Log time on a ticket
- Open Helpdesk ‣ Tickets ‣ All Tickets and select the ticket. Its Project field must be filled (and, to follow the work in the project, its Task).
- Open the Timesheets tab and press Add a line.
- Fill the Date, the Employee, a Description and the Time Spent (hours and minutes, for example 01:30), then save.
The total of the hours is shown under the list. The line is linked to the ticket, to its project and to its task: you do not choose them again. Press the options button at the right of the list header to show the Project and Task columns.
Note
With User: own timesheets only the tab lists only your own lines, not those of your colleagues on the same ticket. You open the tickets you created, the tickets assigned to you and the tickets you follow; if you do not see a ticket, ask its assignee or your team leader to add you as a follower.
Log time on a ticket you follow
An agent who follows a ticket (the Followers button of the ticket) can log time on it even when the project is restricted to its own followers and the agent cannot open the project: the Timesheets tab is there and the line is saved. Follow the ticket first, then log the time as above.
If the project is linked to an inactive analytic account, the tab displays a warning and the list becomes read-only: nobody can log time on the project until the account is changed or reactivated.
Check the hours on the task and in Timesheets
Open the task of the ticket (Project ‣ Tasks): its Timesheets tab lists the same lines, with the total time spent.
Team leader and timesheet approver
Follow the support effort
With User: all timesheets, the Timesheets tab of a ticket shows the lines of every employee, and Timesheets ‣ Timesheets ‣ All Timesheets lists them with all the other timesheets. Group the list by Project and then by Helpdesk Ticket (the grouping options of the search box): each ticket appears under its project with its lines and its total of hours, next to the other projects.
A line that belongs to a ticket is named after its project and its ticket, and an approver can read that name without having access to the ticket itself.
Troubleshooting
- There is no Timesheets tab on the ticket.
- The ticket has no project, the project does not accept timesheets (see Let a project accept timesheets), or you do not hold a Timesheets access right.
- The Timesheets list is read-only and shows a warning.
- The project is linked to an inactive analytic account. Change the account of the project or reactivate it.
FAQ
- Are the hours added to the task as well?
- Yes. A line logged on a ticket that has a task is also a line of that task.
- Can I log time on a ticket of another company?
- No. The ticket and the line must belong to the same company.
- Does the support team need a project?
- Not strictly, but the Timesheets tab works only on a ticket that has a project. Setting a default project on the team avoids choosing it ticket by ticket.
This software and associated files (the "Software") may only be
used
(executed, modified, executed after modifications) if you have
purchased a
valid license from the authors, typically via Odoo Apps,
or if you
have
received a written agreement from the authors of the
Software (see the
COPYRIGHT file).
You may develop Odoo modules that use the Software as a library
(typically
by depending on it, importing it and using its
resources), but
without
copying any source code or material from the
Software. You may distribute
those modules under the license of your
choice, provided that this
license
is compatible with the terms of
the Odoo Proprietary License (For
example:
LGPL, MIT, or proprietary
licenses similar to this one).
It is forbidden to publish, distribute, sublicense, or sell
copies of the
Software or modified copies of the Software.
The above copyright notice and this permission notice must be
included in
all copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND
NONINFRINGEMENT. IN NO EVENT
SHALL THE
AUTHORS OR COPYRIGHT HOLDERS
BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN
ACTION OF CONTRACT, TORT OR OTHERWISE,
ARISING
FROM, OUT OF OR IN
CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
DEALINGS IN THE
SOFTWARE.