-
-
Notifications
You must be signed in to change notification settings - Fork 46
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
- Loading branch information
1 parent
ea9b35e
commit 25de62b
Showing
2 changed files
with
730 additions
and
24 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -1,35 +1,204 @@ | ||
| **This file is going to be generated by oca-gen-addon-readme.** | ||
| ========================================= | ||
| Intrastat Product Declaration for Belgium | ||
| ========================================= | ||
|
|
||
| *Manual changes will be overwritten.* | ||
| .. !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!! | ||
| !! This file is generated by oca-gen-addon-readme !! | ||
| !! changes will be overwritten. !! | ||
| !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!! | ||
| Please provide content in the ``readme`` directory: | ||
| .. |badge1| image:: https://img.shields.io/badge/maturity-Beta-yellow.png | ||
| :target: https://odoo-community.org/page/development-status | ||
| :alt: Beta | ||
| .. |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--belgium-lightgray.png?logo=github | ||
| :target: https://github.com/OCA/l10n-belgium/tree/14.0/l10n_be_intrastat_product | ||
| :alt: OCA/l10n-belgium | ||
| .. |badge4| image:: https://img.shields.io/badge/weblate-Translate%20me-F47D42.png | ||
| :target: https://translation.odoo-community.org/projects/l10n-belgium-14-0/l10n-belgium-14-0-l10n_be_intrastat_product | ||
| :alt: Translate me on Weblate | ||
| .. |badge5| image:: https://img.shields.io/badge/runbot-Try%20me-875A7B.png | ||
| :target: https://runbot.odoo-community.org/runbot/119/14.0 | ||
| :alt: Try me on Runbot | ||
|
|
||
| * **DESCRIPTION.rst** (required) | ||
| * INSTALL.rst (optional) | ||
| * CONFIGURE.rst (optional) | ||
| * **USAGE.rst** (optional, highly recommended) | ||
| * DEVELOP.rst (optional) | ||
| * ROADMAP.rst (optional) | ||
| * HISTORY.rst (optional, recommended) | ||
| * **CONTRIBUTORS.rst** (optional, highly recommended) | ||
| * CREDITS.rst (optional) | ||
| |badge1| |badge2| |badge3| |badge4| |badge5| | ||
|
|
||
| Content of this README will also be drawn from the addon manifest, | ||
| from keys such as name, authors, maintainers, development_status, | ||
| and license. | ||
| This module implements the Belgian Intrastat reporting. | ||
|
|
||
| A good, one sentence summary in the manifest is also highly recommended. | ||
| The report can be reviewed and corrected where needed before | ||
| the creation of the XML file for the online declaration (ONEGATE). | ||
|
|
||
| More information can be found on the National Bank website: | ||
| https://www.nbb.be/en/statistics/foreign-trade | ||
|
|
||
| Automatic changelog generation | ||
| ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ | ||
| **Table of contents** | ||
|
|
||
| `HISTORY.rst` can be auto generated using `towncrier <https://pypi.org/project/towncrier>`_. | ||
| .. contents:: | ||
| :local: | ||
|
|
||
| Just put towncrier compatible changelog fragments into `readme/newsfragments` | ||
| and the changelog file will be automatically generated and updated when a new fragment is added. | ||
| Installation | ||
| ============ | ||
|
|
||
| Please refer to `towncrier` documentation to know more. | ||
| Conflicting modules | ||
| ~~~~~~~~~~~~~~~~~~~ | ||
|
|
||
| NOTE: the changelog will be automatically generated when using `/ocabot merge $option`. | ||
| If you need to run it manually, refer to `OCA/maintainer-tools README <https://github.com/OCA/maintainer-tools>`_. | ||
| This module conflicts with the module *report_intrastat* and *l10n_be_intrastat* | ||
| from the official addons. | ||
| If you have already installed these modules, | ||
| you should uninstall them before installing this module. | ||
|
|
||
| Refund handling | ||
| ~~~~~~~~~~~~~~~ | ||
|
|
||
| We recommend to also install the OCA stock_picking_invoice_link module, | ||
| cf. https://github.com/OCA/stock-logistics-workflow. | ||
| This modules establishes a link between invoice lines and stock pickings. | ||
| When this module is installed the declaration will take into account refunds created via return pickings. | ||
|
|
||
| Multi-company setup | ||
| ~~~~~~~~~~~~~~~~~~~ | ||
|
|
||
| Please ensure to set the Default Company of the OdooBot user to the company | ||
| for which you are installing this localization module. | ||
| Not doing so may result in a conflict with other localization modules (e.g. l10n_fr_intrastat_product). | ||
|
|
||
|
|
||
| Configuration wizard to load intrastat codes | ||
| ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ | ||
|
|
||
| The module comes with a configuration wizard that allows you to load the intrastat codes into the database. | ||
| The intrastat codes are available in 4 languages : english, dutch, french, german. | ||
|
|
||
| If your databases has been configured to support multiple languages, you should execute the wizard | ||
| for each language that you want to offer to the users. | ||
|
|
||
| Configuration | ||
| ============= | ||
|
|
||
| * Accounting -> Configuration -> Settings | ||
|
|
||
| - Arrivals : Exempt, Standard or Extended | ||
| - Dispatches : Exempt, Standard or Extended | ||
| - Default Intrastat Region | ||
| - Default Intrastat Transaction | ||
| - Default Intrastat Transport Mode (Extended Declaration) | ||
| - Default Intrastat Incoterm (Extended Declaration) | ||
|
|
||
| * Warehouse | ||
|
|
||
| Intrastat Region to cope with warehouses in different regions | ||
|
|
||
| * Inrastat Codes, Supplementary Units, Transaction Tyoes, Transport Modes, Regions | ||
|
|
||
| Cf. menu Accounting / Configuration / Intrastat | ||
|
|
||
| The configuration data is loaded when installing the module. | ||
| We recommend no to change these settings. | ||
|
|
||
| A configuration wizard also allows to update the Intrastat Codes so that you can easily | ||
| synchronise your Odoo instance with the latest list of codes supplied with this module | ||
| (an update is published on an annual basis by the Belgian National Bank). | ||
|
|
||
| * Product | ||
|
|
||
| You can define a default Intrastat Code on the Product or the Product Category. | ||
|
|
||
| * Fiscal Positions | ||
|
|
||
| Check your Fiscal Positions and set the 'Intrastat' flag for transactations that | ||
| must be included in the intrastat declaration. | ||
| We recommend to set the 'VAT required' flag on the 'Intra Community Regime' Fiscal Position. | ||
|
|
||
| If you have B2C customers or B2B customers which are not subject to VAT you can create a | ||
| 'Intra Community Regime NA' Fiscal Position on which the 'Intrastat' flag is set while the 'VAT required' | ||
| flag has been turned off. | ||
|
|
||
| * Partner | ||
|
|
||
| Ensure that your B2B Customer records have a valid VAT Number. | ||
|
|
||
| Consider the use of the OCA **account_fiscal_position_vat_check module** to enforce the correct setting. | ||
| Cf. https://github.com/OCA/account-financial-tools. | ||
|
|
||
| If you have not set the 'Detect Automatically' flan on your Intra Community Fiscal Position(s) than you should | ||
| set the 'Intra Community Regime NA' Fiscal Position on B2B customer records who are not subject to VAT. | ||
| Alternatively you can also set 'NA' in the VAT number field of such a customer. | ||
|
|
||
| Known issues / Roadmap | ||
| ====================== | ||
|
|
||
| * The current version of the Belgian Intrastat reporting module is only based on invoices. | ||
| Since associated stock moves are not taken into consideration, it is possible that manual | ||
| corrections are required, e.g. | ||
| Product movements without invoices are not included in the current version | ||
| of this module and must be added manually to the report lines | ||
| before generating the ONEGATE XML declaration. | ||
|
|
||
| * Refunds on invoices within the same reporting period are deducted from the declaration lines. | ||
| No controls are executed on Refunds that are not linked to an invoice | ||
| in the same reporting period. | ||
| Such Refunds are reported under the default transaction code for refunds. | ||
| It is recommend to manually set the correct transaction code while Credit Notes | ||
| are created. | ||
|
|
||
| * The current version of the Belgian Intrastat reporting module does not perform a | ||
| cross-check with the VAT declaration. | ||
|
|
||
| Changelog | ||
| ========= | ||
|
|
||
| This module is also available for olders Odoo versions: | ||
|
|
||
| - Odoo 12.0 - 13.0: cf. https://github.com/Noviat/noviat-apps | ||
|
|
||
| - Odoo 7.0 - 11.0: cf. https://github.com/luc-demeyer/noviat-apps | ||
|
|
||
| Bug Tracker | ||
| =========== | ||
|
|
||
| Bugs are tracked on `GitHub Issues <https://github.com/OCA/l10n-belgium/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 <https://github.com/OCA/l10n-belgium/issues/new?body=module:%20l10n_be_intrastat_product%0Aversion:%2014.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 | ||
| ~~~~~~~ | ||
|
|
||
| * Noviat | ||
|
|
||
| Contributors | ||
| ~~~~~~~~~~~~ | ||
|
|
||
| * Luc De Meyer <[email protected]> | ||
|
|
||
| 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-luc-demeyer| image:: https://github.com/luc-demeyer.png?size=40px | ||
| :target: https://github.com/luc-demeyer | ||
| :alt: luc-demeyer | ||
|
|
||
| Current `maintainer <https://odoo-community.org/page/maintainer-role>`__: | ||
|
|
||
| |maintainer-luc-demeyer| | ||
|
|
||
| This module is part of the `OCA/l10n-belgium <https://github.com/OCA/l10n-belgium/tree/14.0/l10n_be_intrastat_product>`_ project on GitHub. | ||
|
|
||
| You are welcome to contribute. To learn how please visit https://odoo-community.org/page/Contribute. |
Oops, something went wrong.