Antoine Vandevenne (anv)
91c20a2c03
Since odoo/documentation#903, the guideline for the location of new resource (images, downloadable files, RST includes...) files is to place those inside the directory of the RST page that references them. For example, if `doc1.rst` has a reference to `image.png` and to `download.zip`, the file structure should look like this: ├── parent_doc/ │ └── doc1/ │ │ └── image.png │ │ └── download.zip │ └── doc1.rst │ └── doc2.rst ├── parent_doc.rst Before this commit, most of the resource files were still located inside 'media' directories holding all the resource files referenced by RST pages located at the same level as these directories. In the example above, a single 'media' directory would hold all the resource files referenced by both `doc1.rst` and `doc2.rst`. Doing so prevented us from figuring out easily which resource file was referenced by which RST page and, thus, lead to unused resource files piling up in the repository. It also made it more complicated to define codeowners regex rules because a team could not simply be assigned to `/some_page.*` but needed to be assigned to both `/some_page\.rst` and to the location of 'media'. In order to help new content writers figure out the guideline when taking examples from other RST pages, this commit retroactively applies the guideline to existing resource files and 'media' directories. The left-over resource files that are not referenced by any RST page are removed. task-2497965 Part-of: odoo/documentation#2026
71 lines
2.2 KiB
ReStructuredText
71 lines
2.2 KiB
ReStructuredText
========================
|
|
Manage withholding taxes
|
|
========================
|
|
|
|
A withholding tax, also called a retention tax, is a government
|
|
requirement for the payer of a customer invoice to withhold or deduct
|
|
tax from the payment, and pay that tax to the government. In most
|
|
jurisdictions, withholding tax applies to employment income.
|
|
|
|
With normal taxes, the tax is added to the subtotal to give you the
|
|
total to pay. As opposed to normal taxes, withholding taxes are deducted
|
|
from the amount to pay, as the tax will be paid by the customer.
|
|
|
|
As, an example, in Colombia you may have the following invoice:
|
|
|
|
.. image:: retention/retention03.png
|
|
:align: center
|
|
|
|
In this example, the **company** who sent the invoice owes $20 of taxes to
|
|
the **government** and the **customer** owes $10 of taxes to the **government**.
|
|
|
|
Configuration
|
|
=============
|
|
|
|
In Odoo, a withholding tax is defined by creating a negative tax. For a
|
|
retention of 10%, you would configure the following tax (accessible
|
|
through :menuselection:`Configuration --> Taxes`):
|
|
|
|
.. image:: retention/retention04.png
|
|
:align: center
|
|
|
|
In order to make it appear as a retention on the invoice, you should set
|
|
a specific tax group **Retention** on your tax, in the **Advanced Options**
|
|
tab.
|
|
|
|
.. image:: retention/retention02.png
|
|
:align: center
|
|
|
|
Once the tax is defined, you can use it in your products, sales order or
|
|
invoices.
|
|
|
|
.. tip::
|
|
If the retention is a percentage of a regular tax, create a Tax with a
|
|
**Tax Computation** as a **Tax Group** and set the two taxes in this group
|
|
(normal tax and retention).
|
|
|
|
Applying retention taxes on invoices
|
|
====================================
|
|
|
|
Once your tax is created, you can use it on customer forms, sales order
|
|
or customer invoices. You can apply several taxes on a single customer
|
|
invoice line.
|
|
|
|
.. image:: retention/retention01.png
|
|
:align: center
|
|
|
|
.. note::
|
|
When you see the customer invoice on the screen, you get only a
|
|
**Taxes line** summarizing all the taxes (normal taxes & retentions).
|
|
But when you print or send the invoice, Odoo does the correct
|
|
grouping amongst all the taxes.
|
|
|
|
The printed invoice will show the different amounts in each tax group.
|
|
|
|
.. image:: retention/retention03.png
|
|
:align: center
|
|
|
|
.. seealso::
|
|
|
|
* :doc:`taxes`
|