Files
odoo-docs/content/applications/hr/time_off/request_time_off.rst
larm-odoo 7b491b978c [IMP] Time Off: Updating Request Time Off
closes odoo/documentation#14184

Signed-off-by: Lara Martini (larm) <larm@odoo.com>
2025-08-25 20:34:14 +00:00

79 lines
3.9 KiB
ReStructuredText

================
Request time off
================
When employees wish to take time off, they first submit a time off request through the **Time Off**
application. Once their request has been submitted, it is then reviewed by either the employee's
manager or their time off officer (depending on who the employee's :ref:`time off approver is
<employees/approvers>`).
.. note::
If the time off type the employee is requesting :ref:`does not require approval
<time_off/time-off-requests>`, the time off is automatically approved, and does not need to be
reviewed.
Submit time off request
=======================
To request time off, click the :guilabel:`New` button in the top-left corner of the **Time Off** app
dashboard, and a :guilabel:`New Time Off` pop-up form loads.
Fill out the :ref:`fields on the form <time_off/fields>`, and then click :guilabel:`Save & Close` to
submit the request.
.. tip::
Requesting time off can be done either form the main **Time Off** app dashboard, or by navigating
to :menuselection:`Time Off --> My Time --> My Time Off`, and clicking :guilabel:`New`.
.. image:: request_time_off/new-time-off.png
:alt: A time off request for three hours of vacation time off.
.. _time_off/fields:
Time off fields
---------------
Enter the following information on the :guilabel:`New Time Off` request form:
- :guilabel:`Time Off Type`: Using the drop-down menu, select the type of time off being requested.
- :guilabel:`Dates`: Enter the dates that the time off falls under. There are two fields to
populate: the start and end dates. Click on either date field and a popover calendar appears.
Click on the start date, then click on the end date. The selected start and end dates are circled,
and the dates between them are highlighted (if applicable).
If only requesting time off for a single day, click on the start date, then click the same date
again for the end date.
When the correct dates are selected, click the :guilabel:`Apply` button.
The selected dates now populate the two portions of the :guilabel:`Dates` field.
If the selected :guilabel:`Time Off Type` is configured to have the time off taken in hours, the
following two fields also appear:
- :guilabel:`Half Day`: If the time off request is for a half day, tick this checkbox. When this
is selected, the second date field disappears, and is replaced with a drop-down menu. From that
drop-down menu, select either :guilabel:`Morning` or :guilabel:`Afternoon` to indicate which
half of the day is being requested off.
- :guilabel:`Custom Hours`: If the time off requested is not a whole or half day, tick this
checkbox. If selected, a :guilabel:`From` and :guilabel:`To` field appears beneath this option.
Using the drop-down menu, select the start and end time for the time off request.
- :guilabel:`Requested (Days/Hours)`: This field updates automatically once the :guilabel:`Date`
section is completed. If the :guilabel:`Date` section is modified, this section automatically
updates to reflect the total time off requested. This field is in either hours or days, depending
on how the selected :ref:`Time Off Type <time_off/time-off-types>` is configured.
- :guilabel:`Description`: Enter a description for the time off request. This should include any
details that managers and approvers may need to approve the request.
- :guilabel:`Supporting Document`: This field **only** appears if the :ref:`Time Off Type
<time_off/time-off-types>` selected allows for the attachment of documents. Click the
:icon:`fa-paperclip` :guilabel:`Attach File` button, and a file explorer window appears.
Navigate to the desired files that should be attached, select them, then click The
:guilabel:`Open` button. The files then appear on the time off request form. Multiple documents
can be attached, if necessary.
.. image:: request_time_off/time-off-request.png
:alt: A time off request form filled out for an employee home sick with the flu.