IMP l10n_it_vat_registries README (OCA#479) and tests

l10n_it_vat_registries/README.rst

@@ -1,66 +1,147 @@
-.. image:: https://img.shields.io/badge/licence-AGPL--3-blue.svg
-   :target: http://www.gnu.org/licenses/agpl-3.0-standalone.html
-   :alt: License: AGPL-3
-
 =====================================
 Italian Localization - VAT Registries
 =====================================
 
+.. !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
+   !! This file is generated by oca-gen-addon-readme !!
+   !! changes will be overwritten.                   !!
+   !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
+
+.. |badge1| image:: https://img.shields.io/badge/maturity-Production%2FStable-green.png
+    :target: https://odoo-community.org/page/development-status
+    :alt: Production/Stable
+.. |badge2| image:: https://img.shields.io/badge/licence-AGPL--3-blue.png
+    :target: http://www.gnu.org/licenses/agpl-3.0-standalone.html
+    :alt: License: AGPL-3
+.. |badge3| image:: https://img.shields.io/badge/github-OCA%2Fl10n--italy-lightgray.png?logo=github
+    :target: https://github.com/OCA/l10n-italy/tree/10.0/l10n_it_vat_registries
+    :alt: OCA/l10n-italy
+.. |badge4| image:: https://img.shields.io/badge/runbot-Try%20me-875A7B.png
+    :target: https://runbot.odoo-community.org/runbot/122/10.0
+    :alt: Try me on Runbot
+
+|badge1| |badge2| |badge3| |badge4| 
+
 Law: Decreto del Presidente della Repubblica del 26 ottobre 1972 n. 633
 https://goo.gl/31yTVj
 
+**Table of contents**
+
+.. contents::
+   :local:
+
 Configuration
 =============
 
+**Italiano**
+
+E' possibile configurare quali imposte escludere dai registri (ad esempio le ritenute)
+impostando il campo dell'imposta 'Escludi dai registri IVA'
+
+Per generare i periodi fiscali,
+aprire Contabilità > Configurazione > Contabilità > Intervalli date > Genera intervalli date.
+
+* Prefisso: Prefisso identificativo dell'anno dei periodi da generare
+* Durata: 1 mese
+* Numero di intervalli da generare: 12
+* Tipo: Creare un tipo o utilizzarne uno esistente, non è richiesta una configurazione particolare per il tipo
+* Data di inizio: primo giorno dell'anno dei periodi da generare (ad esempio 01/01/2018)
+
+Tramite
+Contabilità -> Configurazione -> Contabilità -> Registri IVA
+è possibile configurare i registri IVA, ad esempio 'vendite', 'acquisti' o 'corrispettivi'.
+Per associare un sezionale ad un registro IVA, aprire il sezionale tramite
+Contabilità -> Configurazione -> Contabilità -> Sezionali
+ed impostare il campo 'Registro IVA'
+
+
+**English**
+
 You can configure which taxes to exclude from registries (like withholding tax)
-setting the 'Exclude from VAT registries' field
+setting the 'Exclude from VAT registries' field.
+
+In order to generate fiscal periods,
+open Accounting > Configuration > Accounting > Date range > Generate Date Ranges and select:
+
+* Prefix: Prefix identifying the year of the periods to be generated
+* Duration: 1 month
+* Number of ranges to generate: 12
+* Type: Create a type or use an existing one, no specific type's configuration is required
+* Date start: first day of the period's year (for instance 01/01/2018)
 
+Using the menu
+Accounting -> Configuration -> Accounting -> VAT registries
+you can configure VAT registries, like 'Sales', 'Purchases' or 'corrispettivi'.
+In order to link a journal to a VAT registry, open journal by
+Accounting -> Configuration -> Accounting -> Journals
+and set the 'VAT registry' field
 
 Usage
 =====
 
-.. image:: https://odoo-community.org/website/image/ir.attachment/5784_f2813bd/datas
-   :alt: Try me on Runbot
-   :target: https://runbot.odoo-community.org/runbot/122/10.0
+**Italiano**
+
+Dal menu
+Contabilità -> Report -> Imposte -> Registri IVA
+è possibile lanciare il wizard di stampa, nel quale è necessario impostare un intervallo di date. Qui è possibile utilizzare un periodo fiscale nel campo 'Intervallo Date'.
+
+Nel campo 'Registro IVA' è possibile selezionare un registro preconfigurato, oppure è possibile andare direttamente a impostare i sezionali ed il layout nei campi sottostanti.
+
+
+**English**
+
+Using the menu
+Accounting -> Reports -> Taxes -> VAT registries
+it is possible to launch the print wizard, where you have to set a date range. You can use a fiscal period in the field 'date range'.
+
+In the 'VAT registry' field you can select a preconfigured registry, or you can directly journals and layout in the fields below.
 
 Bug Tracker
 ===========
 
-Bugs are tracked on `GitHub Issues
-<https://github.com/OCA/l10n-italy/issues>`_. In case of trouble, please
-check there if your issue has already been reported. If you spotted it first,
-help us smash it by providing detailed and welcomed feedback.
+Bugs are tracked on `GitHub Issues <https://github.com/OCA/l10n-italy/issues>`_.
+In case of trouble, please check there if your issue has already been reported.
+If you spotted it first, help us smashing it by providing a detailed and welcomed feedback.
 
+Do not contact contributors directly about support or help with technical issues.
 
 Credits
 =======
 
+Authors
+~~~~~~~
+
+* Agile Business Group
+* LinkIt Srl
+
 Contributors
-------------
+~~~~~~~~~~~~
 
 * Lorenzo Battistini <lorenzo.battistini@agilebg.com>
 * Sergio Corato <sergiocorato@gmail.com>
 * Alex Comba <alex.comba@agilebg.com>
 * Lara Baggio <lbaggio@linkgroup.it>
 
-Funders
--------
+Other credits
+~~~~~~~~~~~~~
 
 The development of this module has been financially supported by:
 
 * Odoo Italia Network
 
-Maintainer
-----------
+Maintainers
+~~~~~~~~~~~
+
+This module is maintained by the OCA.
 
 .. image:: https://odoo-community.org/logo.png
    :alt: Odoo Community Association
    :target: https://odoo-community.org
 
-This module is maintained by the OCA.
-
 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.
 
-To contribute to this module, please visit http://odoo-community.org.
+This module is part of the `OCA/l10n-italy <https://github.com/OCA/l10n-italy/tree/10.0/l10n_it_vat_registries>`_ project on GitHub.
+
+You are welcome to contribute. To learn how please visit https://odoo-community.org/page/Contribute.

l10n_it_vat_registries/__manifest__.py

@@ -1,7 +1,7 @@
 # Copyright 2011-2013 Associazione OpenERP Italia
 # (<http://www.openerp-italia.org>).
 # Copyright 2012 Domsense srl (<http://www.domsense.com>)
-# Copyright 2012-2017 Lorenzo Battistini - Agile Business Group
+# Copyright 2012-2018 Lorenzo Battistini - Agile Business Group
 # Copyright 2012-15 LinkIt srl (<http://http://www.linkgroup.it>)
 # License AGPL-3.0 or later (http://www.gnu.org/licenses/agpl).
 
@@ -13,6 +13,7 @@
               ", LinkIt Srl",
     'website': 'http://www.agilebg.com',
     'license': 'AGPL-3',
+    'development_status': 'Production/Stable',
     "depends": [
         'base_setup',
         'account',

l10n_it_vat_registries/readme/CONFIGURE.rst

@@ -0,0 +1,42 @@
+**Italiano**
+
+E' possibile configurare quali imposte escludere dai registri (ad esempio le ritenute)
+impostando il campo dell'imposta 'Escludi dai registri IVA'
+
+Per generare i periodi fiscali,
+aprire Contabilità > Configurazione > Contabilità > Intervalli date > Genera intervalli date.
+
+* Prefisso: Prefisso identificativo dell'anno dei periodi da generare
+* Durata: 1 mese
+* Numero di intervalli da generare: 12
+* Tipo: Creare un tipo o utilizzarne uno esistente, non è richiesta una configurazione particolare per il tipo
+* Data di inizio: primo giorno dell'anno dei periodi da generare (ad esempio 01/01/2018)
+
+Tramite
+Contabilità -> Configurazione -> Contabilità -> Registri IVA
+è possibile configurare i registri IVA, ad esempio 'vendite', 'acquisti' o 'corrispettivi'.
+Per associare un sezionale ad un registro IVA, aprire il sezionale tramite
+Contabilità -> Configurazione -> Contabilità -> Sezionali
+ed impostare il campo 'Registro IVA'
+
+
+**English**
+
+You can configure which taxes to exclude from registries (like withholding tax)
+setting the 'Exclude from VAT registries' field.
+
+In order to generate fiscal periods,
+open Accounting > Configuration > Accounting > Date range > Generate Date Ranges and select:
+
+* Prefix: Prefix identifying the year of the periods to be generated
+* Duration: 1 month
+* Number of ranges to generate: 12
+* Type: Create a type or use an existing one, no specific type's configuration is required
+* Date start: first day of the period's year (for instance 01/01/2018)
+
+Using the menu
+Accounting -> Configuration -> Accounting -> VAT registries
+you can configure VAT registries, like 'Sales', 'Purchases' or 'corrispettivi'.
+In order to link a journal to a VAT registry, open journal by
+Accounting -> Configuration -> Accounting -> Journals
+and set the 'VAT registry' field

l10n_it_vat_registries/readme/CONTRIBUTORS.rst

@@ -0,0 +1,4 @@
+* Lorenzo Battistini <lorenzo.battistini@agilebg.com>
+* Sergio Corato <sergiocorato@gmail.com>
+* Elena Carlesso <ecarlesso@linkgroup.it>
+* Alex Comba <alex.comba@agilebg.com>

l10n_it_vat_registries/readme/CREDITS.rst

@@ -0,0 +1,3 @@
+The development of this module has been financially supported by:
+
+* Odoo Italia Network

l10n_it_vat_registries/readme/DESCRIPTION.rst

@@ -0,0 +1,2 @@
+Law: Decreto del Presidente della Repubblica del 26 ottobre 1972 n. 633
+https://goo.gl/31yTVj

l10n_it_vat_registries/readme/USAGE.rst

@@ -0,0 +1,16 @@
+**Italiano**
+
+Dal menu
+Contabilità -> Report -> Imposte -> Registri IVA
+è possibile lanciare il wizard di stampa, nel quale è necessario impostare un intervallo di date. Qui è possibile utilizzare un periodo fiscale nel campo 'Intervallo Date'.
+
+Nel campo 'Registro IVA' è possibile selezionare un registro preconfigurato, oppure è possibile andare direttamente a impostare i sezionali ed il layout nei campi sottostanti.
+
+
+**English**
+
+Using the menu
+Accounting -> Reports -> Taxes -> VAT registries
+it is possible to launch the print wizard, where you have to set a date range. You can use a fiscal period in the field 'date range'.
+
+In the 'VAT registry' field you can select a preconfigured registry, or you can directly journals and layout in the fields below.

l10n_it_vat_registries/report/reports.xml

@@ -9,7 +9,6 @@
             name="l10n_it_vat_registries.report_registro_iva"
             file="l10n_it_vat_registries.report_registro_iva"
             menu="False"
-            auto="False"
         />
 
         <record id="action_report_registro_iva" model="ir.actions.report">

l10n_it_vat_registries/tests/test_registry.py

@@ -74,4 +74,4 @@ def test_invoice_and_report(self):
         report = self.env['ir.actions.report'].search(domain)
         html = report.render_qweb_html(res['data']['ids'], res['data'])
 
-        self.assertTrue('Tax 10.0' in html)
+        self.assertTrue(b'Tax 10.0' in html[0])