=========================================
Intrastat Product Declaration for Belgium
=========================================

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

.. |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/15.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-15-0/l10n-belgium-15-0-l10n_be_intrastat_product
    :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/l10n-belgium&target_branch=15.0
    :alt: Try me on Runboat

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

This module implements the Belgian Intrastat reporting.

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

**Table of contents**

.. contents::
   :local:

Installation
============

Conflicting modules
~~~~~~~~~~~~~~~~~~~

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 to smash it by providing a detailed and welcomed
`feedback <https://github.com/OCA/l10n-belgium/issues/new?body=module:%20l10n_be_intrastat_product%0Aversion:%2015.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
~~~~~~~~~~~~

* Noviat <https://noviat.com>
    * Luc De Meyer <luc.demeyer@noviat.com>
    * Jérémy Didderen <jeremy.didderen@noviat.com>

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
.. |maintainer-jdidderen-noviat| image:: https://github.com/jdidderen-noviat.png?size=40px
    :target: https://github.com/jdidderen-noviat
    :alt: jdidderen-noviat

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

|maintainer-luc-demeyer| |maintainer-jdidderen-noviat| 

This module is part of the `OCA/l10n-belgium <https://github.com/OCA/l10n-belgium/tree/15.0/l10n_be_intrastat_product>`_ project on GitHub.

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