Metadata-Version: 2.1
Name: odoo-addon-sale_timesheet_invoice_link
Version: 19.0.0.2.0
Requires-Dist: odoo==19.0.*
Summary: Link invoices with timesheet lines
Home-page: https://github.com/OCA/timesheet
License: LGPL-3
Author: Moduon, Odoo Community Association (OCA)
Author-email: support@odoo-community.org
Classifier: Programming Language :: Python
Classifier: Framework :: Odoo
Classifier: Framework :: Odoo :: 19.0
Classifier: License :: OSI Approved :: GNU Lesser General Public License v3 (LGPLv3)
Classifier: Development Status :: 3 - Alpha
Description-Content-Type: text/x-rst

.. image:: https://odoo-community.org/readme-banner-image
   :target: https://odoo-community.org/get-involved?utm_source=readme
   :alt: Odoo Community Association

===========================
Sale Timesheet Invoice Link
===========================

.. 
   !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
   !! This file is generated by oca-gen-addon-readme !!
   !! changes will be overwritten.                   !!
   !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
   !! source digest: sha256:863c244558cddbb33ffdc1b07fa4d8aae531e39ff38b96d2aaddcdf7a9b64432
   !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!

.. |badge1| image:: https://img.shields.io/badge/maturity-Alpha-red.png
    :target: https://odoo-community.org/page/development-status
    :alt: Alpha
.. |badge2| image:: https://img.shields.io/badge/license-LGPL--3-blue.png
    :target: http://www.gnu.org/licenses/lgpl-3.0-standalone.html
    :alt: License: LGPL-3
.. |badge3| image:: https://img.shields.io/badge/github-OCA%2Ftimesheet-lightgray.png?logo=github
    :target: https://github.com/OCA/timesheet/tree/19.0/sale_timesheet_invoice_link
    :alt: OCA/timesheet
.. |badge4| image:: https://img.shields.io/badge/weblate-Translate%20me-F47D42.png
    :target: https://translation.odoo-community.org/projects/timesheet-19-0/timesheet-19-0-sale_timesheet_invoice_link
    :alt: Translate me on Weblate
.. |badge5| image:: https://img.shields.io/badge/runboat-Try%20me-875A7B.png
    :target: https://runboat.odoo-community.org/builds?repo=OCA/timesheet&target_branch=19.0
    :alt: Try me on Runboat

|badge1| |badge2| |badge3| |badge4| |badge5|

This module extends the functionality of timesheets to support linking
them to preexisting invoices and to allow you to anticipate invoicing,
even before the work hours are actually done.

It also adds a warning alert on invoices that detects timesheets linked
to the invoice's sale order lines that are not yet linked to any
invoice, allowing you to link them all at once or select them manually.

.. IMPORTANT::
   This is an alpha version, the data model and design can change at any time without warning.
   Only for development or testing purpose, do not use in production.
   `More details on development status <https://odoo-community.org/page/development-status>`_

**Table of contents**

.. contents::
   :local:

Use Cases / Context
===================

This module was developed because some people need to sell project hours
in advance, before they have been actually executed, but still want to
have normal traceability.

Odoo normally just links timesheet lines to invoices when they were
linked to a sale order line and, afterwards, that line is invoiced. But
if the invoice was done in advance, there's no linking between the
timesheet and the invoice, and there's no way to link them, not even
manually and not even when the invoice was already done in the past.

Configuration
=============

To be able to use this module, you need these permissions:

- *Timesheets / Administrator*.

Usage
=====

To use this module, you need to:

1. Go to *Timesheets / Timesheets / All Timesheets*.
2. Select the list view.
3. Click on the icon in the top-right corner and display the column
   *Invoice*.
4. Link the timesheet lines with the invoices you want from the same
   customer.

Additionally, when you open an invoice that has timesheets linked to its
sale order lines but not yet linked to the invoice itself, a warning
alert will appear at the top of the invoice form. From there you can:

- Click **Link All** to automatically link all pending timesheets to
  this invoice.
- Click **Select Manually** to open a filtered list of pending
  timesheets where you can select specific ones and click **Link to
  Invoice**.
- Click **Dismiss** to hide the alert for this invoice.

Known issues / Roadmap
======================

- Add a wizard that helps mass-linking done timesheets with their
  invoices.

Bug Tracker
===========

Bugs are tracked on `GitHub Issues <https://github.com/OCA/timesheet/issues>`_.
In case of trouble, please check there if your issue has already been reported.
If you spotted it first, help us to smash it by providing a detailed and welcomed
`feedback <https://github.com/OCA/timesheet/issues/new?body=module:%20sale_timesheet_invoice_link%0Aversion:%2019.0%0A%0A**Steps%20to%20reproduce**%0A-%20...%0A%0A**Current%20behavior**%0A%0A**Expected%20behavior**>`_.

Do not contact contributors directly about support or help with technical issues.

Credits
=======

Authors
-------

* Moduon

Contributors
------------

- Jairo Llopis (`Moduon <https://www.moduon.team/>`__)
- Emilio Pascual (`Moduon <https://www.moduon.team/>`__)

Maintainers
-----------

This module is maintained by the OCA.

.. image:: https://odoo-community.org/logo.png
   :alt: Odoo Community Association
   :target: https://odoo-community.org

OCA, or the Odoo Community Association, is a nonprofit organization whose
mission is to support the collaborative development of Odoo features and
promote its widespread use.

.. |maintainer-rafaelbn| image:: https://github.com/rafaelbn.png?size=40px
    :target: https://github.com/rafaelbn
    :alt: rafaelbn
.. |maintainer-yajo| image:: https://github.com/yajo.png?size=40px
    :target: https://github.com/yajo
    :alt: yajo

Current `maintainers <https://odoo-community.org/page/maintainer-role>`__:

|maintainer-rafaelbn| |maintainer-yajo| 

This module is part of the `OCA/timesheet <https://github.com/OCA/timesheet/tree/19.0/sale_timesheet_invoice_link>`_ project on GitHub.

You are welcome to contribute. To learn how please visit https://odoo-community.org/page/Contribute.
