documentation/content/applications/finance/accounting/taxation/taxes/vat_validation.rst
Antoine Vandevenne (anv) 250bc3ab21 [MOV] content/*: move resource files into their related page's directory
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#2066
2022-05-20 14:48:37 +02:00

43 lines
1.6 KiB
ReStructuredText

===========================
VIES VAT numbers validation
===========================
**VAT Information Exchange System** - abbreviated **VIES** - is a tool provided by the European
Commission that allows you to check the validity of VAT numbers of companies registered in the
European Union.
Odoo provides a feature to **Verify VAT Numbers** when you save a contact. This helps you make sure
that your contacts provided you with a valid VAT number without leaving Odoo interface.
Configuration
=============
To enable this feature, go to :menuselection:`Accounting --> Configuration --> Settings --> Taxes`,
enable the **Verify VAT Numbers** feature, and click on *Save*.
.. image:: vat_validation/vat-validation-configuration.png
:align: center
:alt: Enable "Verify VAT Numbers" in Odoo Accounting
VAT Number validation
=====================
Whenever you create or modify a contact, make sure to fill out the **Country** and **VAT** fields.
.. image:: vat_validation/vat-validation-contact-form.png
:align: center
:alt: Fill out the contact form with the country and VAT number before clicking on *Save*
When you click on *Save*, Odoo runs a VIES VAT number check, and displays an error message if the
VAT number is invalid.
.. image:: vat_validation/vat-validation-error.png
:align: center
:alt: Odoo displays an error message instead of saving when the VAT number is invalid
.. important::
This tool checks the VAT number's validity but does not check the other fields' validity.
.. seealso::
- `European Commission: VIES search engine <https://ec.europa.eu/taxation_customs/vies/vatRequest.html>`__