[IMP] create JavaScript howtos

The JavaScript cheatsheet is outdated, we therefore remove it and
replace it by multiple howtos:

- Create a view from scratch
- Extending an existing view
- Create a field from scratch
- Extend an existing field
- Create a client action

There is other subjects to introduce as the web framework is big. Other
future contributions will cover them.

X-original-commit: 7e4435deb8

.tx/config

@@ -51,11 +51,6 @@ file_filter = locale/<lang>/LC_MESSAGES/services.po
 source_file = locale/sources/services.pot
 source_lang = en
 
-[o:odoo:p:odoo-16-doc:r:theme]
-file_filter = locale/<lang>/LC_MESSAGES/sphinx.po
-source_file = locale/sources/sphinx.pot
-source_lang = en
-
 [o:odoo:p:odoo-16-doc:r:user_settings]
 file_filter = locale/<lang>/LC_MESSAGES/settings.po
 source_file = locale/sources/settings.pot

Makefile

@@ -26,7 +26,7 @@ SOURCE_DIR     = content
 
 HTML_BUILD_DIR = $(BUILD_DIR)/html
 ifdef VERSIONS
-  HTML_BUILD_DIR := $(HTML_BUILD_DIR)/saas-16.1
+  HTML_BUILD_DIR := $(HTML_BUILD_DIR)/saas-16.2
 endif
 ifneq ($(CURRENT_LANG),en)
   HTML_BUILD_DIR := $(HTML_BUILD_DIR)/$(CURRENT_LANG)
@@ -85,4 +85,4 @@ static: $(HTML_BUILD_DIR)/_static/style.css
 	cp -r static/* $(HTML_BUILD_DIR)/_static/
 
 test:
-	python tests/rst_style.py $(SOURCE_DIR)
+	@python tests/main.py $(SOURCE_DIR)/administration $(SOURCE_DIR)/applications $(SOURCE_DIR)/contributing $(SOURCE_DIR)/developer $(SOURCE_DIR)/services redirects

conf.py

@@ -22,7 +22,7 @@ copyright = 'Odoo S.A.'
 # `version` is the version info for the project being documented, acts as replacement for |version|,
 # also used in various other places throughout the built documents.
 # `release` is the full version, including alpha/beta/rc tags. Acts as replacement for |release|.
-version = release = 'saas-16.1'
+version = release = 'saas-16.2'
 
 # `current_branch` is the technical name of the current branch.
 # E.g., saas-15.4 -> saas-15.4; 12.0 -> 12.0, master -> master (*).
@@ -213,6 +213,7 @@ sphinx.transforms.i18n.docname_to_domain = (
 # is populated. If a version is passed to `versions` but is not listed here, it will not be shown.
 versions_names = {
     'master': "Master",
+    'saas-16.2': "Odoo Online",
     'saas-16.1': "Odoo Online",
     '16.0': "Odoo 16",
     'saas-15.2': "Odoo Online",
@@ -318,6 +319,12 @@ latex_documents = [
      'odoo_partnership_agreement_es.tex', 'Odoo Partnership Agreement (ES)', '', 'howto'),
 ]
 
+# List of languages that have legal translations (excluding EN). The keys must be in
+# `languages_names`. These translations will have a link to their versions of the legal
+# contracts, instead of the default EN one. The main legal documents are not part of the
+# translations since they have legal meaning.
+legal_translations = ['de', 'es', 'fr', 'nl']
+
 # The name of an image file (relative to this directory) to place at the top of the title page.
 latex_logo = 'static/img/odoo_logo.png'
 
@@ -446,6 +453,10 @@ def _generate_alternate_urls(app, pagename, templatename, context, doctree):
                     )
                 )
 
+        # Dynamic generation of localized legal doc links
+        context['legal_translations'] = legal_translations
+
+
     def _build_url(_version=None, _lang=None):
         if app.config.is_remote_build:
             # Project root like https://www.odoo.com/documentation

content/administration/install/cdn.rst

@@ -1,80 +1,109 @@
-===========================================
-Setting up a Content Delivery Network (CDN)
-===========================================
+=======================================
+Set up a content delivery network (CDN)
+=======================================
 
 .. _reference/cdn/keycdn:
 
-Deploying with KeyCDN_
-======================
+Deploying with KeyCDN
+=====================
 
-.. sectionauthor:: Fabien Meghazi
+A :abbr:`CDN (Content Delivery Network)` or *content distribution network*, is a geographically
+distributed network of servers that provides high speed internet content. The :abbr:`CDN (Content
+Delivery Network)` provides quick, high-quality content delivery for content-heavy websites.
 
-This document will guide you through the setup of a KeyCDN_ account with your
-Odoo powered website.
+This document will guide you through the setup of a KeyCDN_ account with an Odoo powered website.
 
-Step 1: Create a pull zone in the KeyCDN dashboard
---------------------------------------------------
+Create a pull zone in the KeyCDN dashboard
+------------------------------------------
 
-.. image:: cdn/keycdn_create_a_pull_zone.png
-   :class: img-fluid
+On the KeyCDN dashboard, start by navigating to the :menuselection:`Zones` menu item on the left. On
+the form, give a value to the :guilabel:`Zone Name`, which will appear as part of the :abbr:`CDN
+(Content Delivery Network)`'s :abbr:`URL (Uniform Resource Locator)`. Then, set the :guilabel:`Zone
+Status` to :guilabel:`active` to engage the zone. For the :guilabel:`Zone Type` set the value to
+:guilabel:`Pull`, and then, finally, under the :guilabel:`Pull Settings`, enter the
+:guilabel:`Origin URL`— this address should be the full Odoo database :abbr:`URL (Uniform Resource
+Locator)`.
 
-When creating the zone, enable the CORS option in the
-:guilabel:`advanced features` submenu. (more on that later)
+.. example::
+   Use ``https://yourdatabase.odoo.com`` and replace the *yourdatabase* subdomain prefix with the
+   actual name of the database. A custom :abbr:`URL (Uniform Resource Locator)` can be used, as
+   well, in place of the Odoo subdomain that was provided to the database.
 
-.. image:: cdn/keycdn_enable_CORS.png
-   :class: img-fluid
+.. image:: cdn/keycdn-zone.png
+   :align: center
+   :alt: KeyCDN's Zone configuration page.
 
-Once done, you'll have to wait a bit while KeyCDN_ is crawling your website.
+Under the :guilabel:`General Settings` heading below the zone form, click the :guilabel:`Show all
+settings` button to expand the zone options. This should be the last option on the page. After
+expanding the :guilabel:`General Settings` ensure that the :guilabel:`CORS` option is
+:guilabel:`enabled`.
 
-.. image:: cdn/keycdn_progressbar.png
-   :class: img-fluid
+Next, scroll to the bottom of the zone configuration page and :guilabel:`Save` the changes. KeyCDN
+will indicate that the new zone will be deployed. This can take about 10 minutes.
 
-.. note:: a new URL has been generated for your Zone, in this case it is
-          ``http://pulltest-b49.kxcdn.com``
+.. image:: cdn/zone-url.png
+   :align: center
+   :alt: KeyCDN deploying the new Zone.
 
-Step 2: Configure the odoo instance with your zone
---------------------------------------------------
+.. note::
+   A new :guilabel:`Zone URL` has been generated for your Zone, in this example it is
+   ``pulltest-xxxxx.kxcdn.com``. This value will differ for each database.
 
-In the Odoo back end, go to the :guilabel:`Website Settings`: menu, then
-activate the CDN support and copy/paste your zone URL in the
-:guilabel:`CDN Base URL` field. This field is only visible and configurable if
-you have developer mode activated.
+Copy this :guilabel:`Zone URL` to a text editor for later, as it will be used in the next steps.
 
-.. image:: cdn/odoo_cdn_base_url.png
-   :class: img-fluid
+Configure the Odoo instance with the new zone
+---------------------------------------------
 
-Now your website is using the CDN for the resources matching the
-:guilabel:`CDN filters` regular expressions.
+In the Odoo :guilabel:`Website` app, go to the :menuselection:`Settings` and then activate the
+:guilabel:`Content Delivery Network (CDN)` setting and copy/paste the :guilabel:`Zone URL` value
+from the earlier step into the :guilabel:`CDN Base URL` field. This field is only visible and
+configurable when :doc:`Developer Mode <../../applications/general/developer_mode>` is activated.
 
-You can have a look to the HTML of your website in order to check if the CDN
-integration is properly working.
+.. note::
+   Ensure that there are two *forward slashes* (`//`) before the :guilabel:`CDN Base URL` and one
+   forward slash (`/`) after the :guilabel:`CDN Base URL`.
 
-.. image:: cdn/odoo_check_your_html.png
-   :class: img-fluid
+:guilabel:`Save` the settings when complete.
 
+.. image:: cdn/cdn-base-url.png
+   :align: center
+   :alt: Activate the CDN setting in Odoo.
 
-Why should I activate CORS?
----------------------------
+Now the website is using the CDN for the resources matching the :guilabel:`CDN filters` regular
+expressions.
 
-A security restriction in some browsers (Firefox and Chrome at time of writing)
-prevents a remotely linked CSS file to fetch relative resources on this same
-external server.
+In the HTML of the Odoo website, the :abbr:`CDN (content delivery network)` integration is evidenced
+as working properly by checking the :abbr:`URL (Uniform Resource Locators)` of images. The *CDN Base
+URL* value can be seen by using your web browser's :guilabel:`Inspect` feature on the Odoo website.
+Look for it's record by searching within the :guilabel:`Network` tab inside of devtools.
 
-If you don't activate the CORS option in the CDN zone, the more obvious
-resulting problem on a default Odoo website will be the lack of font-awesome
-icons because the font file declared in the font-awesome CSS won't be loaded on
-the remote server.
+.. image:: cdn/test-pull.png
+   :align: center
+   :alt: The CDN Base URL can be seen using the inspect function on the Odoo website.
 
-Here's what you would see on your homepage in such a case:
+Prevent security issues by activating cross-origin resource sharing (CORS)
+--------------------------------------------------------------------------
 
-.. image:: cdn/odoo_font_file_not_loaded.png
-   :class: img-fluid
+A security restriction in some browsers (such as Mozilla Firefox and Google Chrome) prevents a
+remotely linked CSS file to fetch relative resources on this same external server.
 
-A security error message will also appear in the browser's console:
+If the :abbr:`CORS (Cross-Origin Resource Sharing)` option isn't enabled in the :guilabel:`CDN
+Zone`, the more obvious resulting problem on a standard Odoo website will be the lack of *Font
+Awesome* icons because the font file declared in the *Font Awesome* CSS won't be loaded from the
+remote server.
 
-.. image:: cdn/odoo_security_message.png
-   :class: img-fluid
+When these cross-origin resource issues occur, a security error message similar to the output
+below will appear in the web browser's developer console:
 
-Enabling the CORS option in the CDN fixes this issue.
+``Font from origin 'http://pulltest-xxxxx.kxcdn.com' has been blocked from loading /shop:1 by
+Cross-Origin Resource Sharing policy: No 'Access-Control-Allow-Origin' header is present on the
+requested resource. Origin 'http://yourdatabase.odoo.com' is therefore not allowed access.``
+
+.. image:: cdn/odoo-security-message.png
+   :align: center
+   :alt: Error message populated in the browser console.
+
+Enabling the :abbr:`CORS (Cross-Origin Resource Sharing)` option in the :abbr:`CDN (Content Delivery
+Network)` settings fixes this issue.
 
 .. _KeyCDN: https://www.keycdn.com

content/administration/maintain/azure_oauth.rst

@@ -11,6 +11,10 @@ personal email address or an address created by a custom domain.
    `Microsoft Learn: Register an application with the Microsoft identity platform
    <https://learn.microsoft.com/azure/active-directory/develop/quickstart-register-app>`_
 
+.. seealso::
+   - :doc:`/applications/general/auth/azure`
+   - :doc:`/applications/general/calendars/outlook/outlook_calendar`
+
 Setup in Microsoft Azure Portal
 ===============================
 
@@ -161,9 +165,9 @@ Then, create a new email server and check the box for :guilabel:`Outlook`. Next,
 :guilabel:`Name` (it can be anything) and the Microsoft Outlook email :guilabel:`Username`.
 
 If the :guilabel:`From Filter` field is empty, enter either a :ref:`domain or email address
-<email_communication/default_from>`.
+<email_communication/default>`.
 
-Then, cick on :guilabel:`Connect your Outlook account`.
+Then, click on :guilabel:`Connect your Outlook account`.
 
 A new window from Microsoft opens to complete the :guilabel:`authorization process`. Select the
 appropriate email address that is being configured in Odoo.

content/administration/maintain/google_oauth.rst

@@ -11,6 +11,10 @@ email address or an address created by a custom domain.
    For more information, visit `Google's documentation
    <https://support.google.com/cloud/answer/6158849>`_ on setting up OAuth.
 
+.. seealso::
+   - :doc:`/applications/general/auth/google`
+   - :doc:`/applications/general/calendars/google/google_calendar_credentials`
+
 Setup in Google
 ===============
 

content/administration/maintain/mailjet_api.rst

@@ -201,7 +201,7 @@ Connection`.
    #. The :guilabel:`From Filter` needs to be set on the server configuration. It is recommended
       to set it as a domain and not a full email address. It should match the domain in the two
       proceeding steps. More information can be referenced :ref:`here
-      <email_servers/outgoing-email-server>`.
+      <email_communication/from_filter>`.
    #. The :guilabel:`mail.default.from` system parameter must have the value
       `notifications\@yourdomain.com`.
    #. The :guilabel:`mail.default.from_filter` system parameter must have the value

content/administration/maintain/odoo_online.rst

@@ -3,20 +3,22 @@ Odoo Online database management
 ===============================
 
 To manage a database, sign in to https://www.odoo.com and access the `database management page
-<https://www.odoo.com/my/databases>`_ by clicking on the user icon, then on *My Databases*.
+<https://www.odoo.com/my/databases>`_ by clicking on the user icon, then on
+:guilabel:`My Databases`.
 
 .. image:: odoo_online/my-databases.png
    :align: center
    :alt: Clicking on the user icon opens a drop-down menu. "My databases" button is highlighted.
 
 .. note::
-   Make sure you are connected as the administrator of the database you want to manage.
+   Make sure to connect as the administrator of the database that changes will be made on.
 
 .. image:: odoo_online/dropdown-menu.png
    :align: right
    :alt: Clicking on the gear icon opens the drop-down menu.
 
-Open the drop-down menu next to the database you want to manage by clicking on the gear icon.
+Open the drop-down menu next to the database that changes will be made on by clicking on the gear
+icon.
 
 Several actions are available:
 
@@ -35,22 +37,22 @@ Several actions are available:
 Upgrade
 =======
 
-If you are *not* on the latest **Online version**, you should receive an invitation to :doc:`upgrade
-<../upgrade>` your database. A **Rolling Release button** on your database's main screen proposes an
-upgrade to the latest version (e.g., 13.0 to 15.1).
+If the database is *not* on the latest **Online version**, the administrator should receive an
+invitation to :doc:`upgrade <../upgrade>` the database. A :guilabel:`Rolling Release`` button on the
+database's main screen proposes an upgrade to the latest version (e.g., 14.0 to 16.1).
 
 .. important::
-   - | **If your Odoo database's version is lower than the latest major release:**
-     | You must upgrade your database within two months. After these two months, an automatic
+   - | **If the Odoo database's version is lower than the latest major release:**
+     | The database must be upgraded within two months. After these two months, an automatic
        upgrade is initiated.
-   - | **If your Odoo database's version is equal to or higher than the latest major release:**
-     | You can disregard the invitation to upgrade as you probably wouldn't benefit from new
+   - | **If the Odoo database's version is equal to or higher than the latest major release:**
+     | Disregard the invitation to upgrade as the database probably wouldn't benefit from new
        features every two months.
 
 .. note::
    Versions that are not supported anymore become deprecated and need to be updated to avoid
-   security issues. We recommend you initiate the upgrade of the database yourself, as this method
-   allows you to request a test upgrade of your database to check for any discrepancies.
+   security issues. Odoo recommends that the company initiate the upgrade, as this method allows for
+   the company to request a test upgrade of the database to check for any discrepancies.
 
 .. seealso::
    - :doc:`../upgrade`
@@ -61,12 +63,12 @@ upgrade to the latest version (e.g., 13.0 to 15.1).
 Duplicate
 =========
 
-Make an exact copy of the database to be able to perform testing without compromising the daily
-operations.
+This allows to make an exact copy of the database to be able to perform testing without compromising
+the daily operations.
 
 .. important::
-   - By checking *For testing purposes*, all external communication (emails, payments, delivery
-     orders, etc.) are disabled by default on the duplicated database.
+   - By checking :guilabel:`For testing purposes`, all external communication (emails, payments,
+     delivery orders, etc.) are disabled by default on the duplicated database.
    - Duplicate databases expire automatically after 15 days.
 
 .. _odoo_online/rename:
@@ -81,7 +83,7 @@ Rename the database and its URL.
 Download
 ========
 
-Download instantly a ZIP file with a backup of the database.
+Instantly download a ZIP file with a backup of the database.
 
 .. note::
    Databases are backed up daily according to the `Odoo Cloud SLA
@@ -115,8 +117,8 @@ Delete a database instantly.
    Deleting a database means that all data is permanently lost. The deletion is instant and for all
    users. It is recommended to create a backup of the database before deleting it.
 
-Read carefully the warning message that pops up and proceed only if you fully understand the
-implications of deleting a database:
+Carefully read the warning message that pops up and proceed only if the implications of deleting a
+database are fully understood:
 
 .. image:: odoo_online/delete.png
    :align: center
@@ -127,7 +129,6 @@ implications of deleting a database:
    - The database name is immediately available for a new database.
    - It is not possible to delete a database if it is expired or linked to a subscription. If
      needed, please get in touch with `Odoo Support <https://www.odoo.com/help>`_.
-   - To delete your account, please get in touch with `Odoo Support <https://www.odoo.com/help>`_.
 
 .. _odoo_online/contact-support:
 
@@ -142,14 +143,15 @@ pre-filled.
 Invite / Remove Users
 =====================
 
-To invite users, fill out the email address of the new user and click on *Invite*. To add multiple
-users, click on *Add more users*.
+To invite users, fill out the email address of the new user and click on :guilabel:`Invite`. To add
+multiple users, click on :guilabel:`Add more users`.
 
 .. image:: odoo_online/invite-users.png
    :align: center
    :alt: Clicking on "Add more users" adds additional email fields.
 
-To remove users, select the users to remove and click on *Remove*.
+To remove users, select the users to remove and click on :guilabel:`Remove`.
 
 .. seealso::
    - :doc:`/applications/general/users/manage_users`
+   - :doc:`/applications/general/users/delete_account`

content/administration/maintain/supported_versions.rst

@@ -26,9 +26,13 @@ This matrix shows the support status of every version.
 +-----------------+-------------+----------+-------------+----------------+------------------------+
 |                 | Odoo Online | Odoo.sh  | On-Premise  | Release date   | End of support         |
 +=================+=============+==========+=============+================+========================+
+| Odoo saas~16.2  | |green|     | N/A      | N/A         | March 2023     | June 2023 (planned)    |
++-----------------+-------------+----------+-------------+----------------+------------------------+
+| Odoo saas~16.1  | |green|     | N/A      | N/A         | February 2023  | April 2023             |
++-----------------+-------------+----------+-------------+----------------+------------------------+
 | **Odoo 16.0**   | |green|     | |green|  | |green|     | October 2022   | October 2025 (planned) |
 +-----------------+-------------+----------+-------------+----------------+------------------------+
-| Odoo saas~15.2  | |green|     | N/A      | N/A         | March 2022     | January 2023           |
+| Odoo saas~15.2  | |red|       | N/A      | N/A         | March 2022     | January 2023           |
 +-----------------+-------------+----------+-------------+----------------+------------------------+
 | Odoo saas~15.1  | |red|       | N/A      | N/A         | February 2022  | July 2022              |
 +-----------------+-------------+----------+-------------+----------------+------------------------+

content/applications.rst

@@ -18,6 +18,7 @@ Discover our user guides and configuration tutorials per application.
     applications/sales
     applications/websites
     applications/inventory_and_mrp
+    applications/hr
     applications/marketing
     applications/services
     applications/productivity

content/applications/finance/accounting/bank.rst

@@ -8,6 +8,7 @@ Bank and cash
    :titlesonly:
 
    bank/setup
-   bank/feeds
-   bank/misc
+   bank/bank_synchronization
+   bank/transactions
    bank/reconciliation
+   bank/interbank

content/applications/finance/accounting/bank/bank_synchronization.rst

@@ -1,6 +1,8 @@
-======================================
-Bank synchronization: automatic import
-======================================
+:show-content:
+
+====================
+Bank synchronization
+====================
 
 Odoo can synchronize directly with your bank institution to get all bank statements imported
 automatically into your database.
@@ -15,9 +17,12 @@ To connect to the banks, Odoo uses multiple web-services:
 
 - **Plaid**: United States of America and Canada
 - **Yodlee**: Worldwide
-- **Salt Edge**: Europe (:doc:`more information <saltedge>`)
-- **Ponto**: Europe (:doc:`more information <ponto>`)
-- **EnableBanking**: Scandinavian countries
+- :doc:`Salt Edge <bank_synchronization/saltedge>`: Europe
+- :doc:`Ponto <bank_synchronization/ponto>`: Europe
+- :doc:`Enable Banking <bank_synchronization/enablebanking>`: Scandinavian countries
+
+.. seealso::
+   :doc:`transactions`
 
 Configuration
 =============
@@ -196,7 +201,9 @@ You can update your credentials by going to :menuselection:`Accounting Dashboard
 Configuration --> Accounting: Online Synchronization`,open the connection you want to update your
 credentials and click on the :guilabel:`Update Credentials` button.
 
-.. seealso::
-   * :doc:`bank_statements`
-   * :doc:`ponto`
-   * :doc:`saltedge`
+.. toctree::
+   :titlesonly:
+
+   bank_synchronization/saltedge
+   bank_synchronization/ponto
+   bank_synchronization/enablebanking

content/applications/finance/accounting/bank/bank_synchronization/enablebanking.rst

@@ -0,0 +1,36 @@
+==============
+Enable Banking
+==============
+
+**Enable Banking** is a third-party provider aggregating banking information from bank accounts all
+in one place. It offers non-intrusive connectivity to ASPSPs' official APIs across Europe without
+storing data.
+
+.. image:: enablebanking/enablebanking.png
+   :align: center
+   :alt:   Enable Banking logo
+
+**Odoo** synchronizes directly with banks to get access to all bank transactions and automatically
+import them into your database.
+
+.. seealso::
+   - :doc:`../bank_synchronization`
+   - `Enable Banking website <https://enablebanking.com/>`_
+
+Configuration
+=============
+
+Link bank accounts with Odoo
+----------------------------
+
+#. Start synchronization by clicking on :menuselection:`Accounting --> Configuration -->
+   Add a Bank Account`;
+#. Select your bank;
+#. Make sure you give your consent to share your account information with Odoo by clicking
+   :guilabel:`Continue authentication`;
+
+   .. image:: enablebanking/enablebankingauth.png
+      :align: center
+      :alt: Enable Banking authentication page
+
+#. Finally, you are redirected to your bank's login page.

content/applications/finance/accounting/bank/bank_synchronization/ponto.rst

@@ -1,6 +1,6 @@
-======================================
-Ponto as bank synchronization provider
-======================================
+=====
+Ponto
+=====
 
 **Ponto** is a service that allows companies and professionals to aggregate their accounts in one
 place and directly see all their transactions within one app. It is a third-party solution that is
@@ -16,9 +16,9 @@ into your database.
 Ponto is a paid third-party provider that can handle the synchronization between your bank accounts
 and Odoo. `Its pricing is 4€/month per account/integration <https://myponto.com/en#pricing>`_.
 
-.. note::
-   You can find more information about bank synchronization :doc:`on this page
-   <bank_synchronization>`.
+.. seealso::
+   - :doc:`../bank_synchronization`
+   - :doc:`../transactions`
 
 Configuration
 =============
@@ -115,10 +115,3 @@ and we advise you to contact Ponto directly.
 .. important::
    Using an institution in beta is beneficial for Ponto, it allows them to have real
    feedback on the connection with the institution.
-
-
-.. seealso::
-
-   * :doc:`bank_synchronization`
-   * :doc:`saltedge`
-   * :doc:`bank_statements`

content/applications/finance/accounting/bank/bank_synchronization/saltedge.rst

@@ -1,6 +1,6 @@
-==========================================
-Salt Edge as bank synchronization provider
-==========================================
+=========
+Salt Edge
+=========
 
 **Salt Edge** is a third-party provider that aggregates banking information
 from your bank accounts. It supports ~5000 institutions in more than 50
@@ -8,12 +8,15 @@ countries.
 
 .. image:: saltedge/saltedge-logo.png
    :align: center
+   :width: 50%
    :alt: Salt Edge Logo
 
 Odoo can synchronize directly with your bank to get all bank statements imported
 automatically into your database.
 
-Salt Edge is a free third-party provider.
+.. seealso::
+   - :doc:`../bank_synchronization`
+   - :doc:`../transactions`
 
 Configuration
 =============
@@ -103,9 +106,3 @@ In case you already have a connection with the same credentials present on your
 and this synchronization was created with Odoo, you will normally be able to find it by going to
 :menuselection:`Accounting --> Configuration --> Online Synchronization`. Please make sure to do an
 *Update Credentials* to reactivate the connection.
-
-.. seealso::
-
-   * :doc:`bank_synchronization`
-   * :doc:`ponto`
-   * :doc:`bank_statements`

content/applications/finance/accounting/bank/feeds.rst

@@ -1,13 +0,0 @@
-:nosearch:
-
-==========
-Bank feeds
-==========
-
-.. toctree::
-   :titlesonly:
-
-   feeds/bank_statements
-   feeds/bank_synchronization
-   feeds/ponto
-   feeds/saltedge

content/applications/finance/accounting/bank/feeds/bank_statements.rst

@@ -1,62 +0,0 @@
-===============
-Bank statements
-===============
-
-Importing your bank statements allows you to keep track of your bank account transactions and
-reconcile them with the ones recorded in Odoo.
-
-We recommend using :doc:`the bank synchronization feature <bank_synchronization>` for more
-efficiency. However, if you do not want to use it or if your bank is not yet supported, other
-options exist:
-
-- Import the bank statement files delivered by your bank;
-- Register the bank statements manually.
-
-Import bank statements files
-============================
-
-Odoo supports multiple file formats to import bank statements:
-
-- SEPA recommended Cash Management format (CAMT.053);
-- Comma-separated values (.CSV);
-- Open Financial Exchange (.OFX);
-- Quicken Interchange Format (.QIF);
-- Belgium: Coded Statement of Account (.CODA).
-
-To import a file, go to the Accounting dashboard and click on :guilabel:`Import (Statements)` under
-the :guilabel:`Bank` window, or click on the drop-down menu (:guilabel:`⋮`) button and then on
-:guilabel:`Import Statement`.
-
-.. image:: bank_statements/bank-overview.png
-   :align: center
-   :alt: Import a bank statement file in Odoo Accounting
-
-Next, select the file you want to import and click on :guilabel:`Upload`.
-
-Once the file uploaded, the **import widget** helps you set formatting options and **map** the
-different columns you want to import. You also can :guilabel:`test` the bank statement file before
-importing it to your database.
-
-.. image:: bank_statements/import-bank-statement.png
-   :align: center
-   :alt: Register bank statements manually in Odoo Accounting
-
-Register bank statements manually
-=================================
-
-If needed, you can also record your bank statements manually. To do so, go to the
-:guilabel:`Accounting dashboard` and click on the :guilabel:`Create Statements` under the
-:guilabel:`Bank` window. Alternatively, you can click the drop-down menu (:guilabel:`⋮`) button, and
-then :guilabel:`New Statement`.
-
-To ease the reconciliation process, make sure to fill out the :guilabel:`Partner` field. You can
-also type in the payments’ references in the :guilabel:`Label` field. Add a new line for each
-transaction written on the original bank statement.
-
-.. image:: bank_statements/bank-statements-03.png
-   :align: center
-   :alt: Register bank statements manually in Odoo Accounting
-
-.. note::
-   The **Ending Balance** and the **Computed Balance** should have the same amount. If this is not
-   the case, make sure there are no mistakes in the transactions’ amounts.

content/applications/finance/accounting/bank/interbank.rst

@@ -15,8 +15,8 @@ Settings` and then under the :guilabel:`Default Accounts` section.
 
 .. note::
    At least two bank accounts are needed to make internal transfers. Refer to
-   :doc:`Bank and cash accounts section <../setup/bank_accounts>` to see how to add an additional
-   bank account to your database.
+   :doc:`Bank and cash accounts section <setup/bank_accounts>` to see how to add an additional bank
+   account to your database.
 
 Register an internal transfer from one bank to another
 ======================================================
@@ -91,8 +91,8 @@ Manage and reconcile bank statements
 ------------------------------------
 
 The next step is to book the bank statements to finalize the transaction by creating,
-:doc:`importing <../feeds/bank_statements>`, or :doc:`synchronizing <../feeds/bank_synchronization>`
-your :guilabel:`Transactions lines`. Fill in the :guilabel:`Ending balance` and click on the
+:doc:`importing <transactions>`, or :doc:`synchronizing <bank_synchronization>` your
+:guilabel:`Transactions lines`. Fill in the :guilabel:`Ending balance` and click on the
 :guilabel:`Reconcile` button.
 
 .. image:: interbank/transactions-line.png
@@ -100,7 +100,7 @@ your :guilabel:`Transactions lines`. Fill in the :guilabel:`Ending balance` and
    :alt: Transaction lines to be filled in prior to reconciliation
 
 .. seealso::
-   - :doc:`../reconciliation/use_cases`
+   :doc:`reconciliation/use_cases`
 
 In the next window, choose counterparts for the payment - in this example, the outstanding payment
 account - then click :guilabel:`Validate`.

content/applications/finance/accounting/bank/misc.rst

@@ -1,10 +0,0 @@
-:nosearch:
-
-=============
-Miscellaneous
-=============
-
-.. toctree::
-   :titlesonly:
-
-   misc/interbank

content/applications/finance/accounting/bank/reconciliation/reconciliation_models.rst

@@ -125,5 +125,5 @@ line*.
 .. seealso::
 
    - :doc:`use_cases`
-   - :doc:`../feeds/bank_synchronization`
+   - :doc:`../bank_synchronization`
    - :doc:`../../receivables/customer_invoices/cash_discounts`

content/applications/finance/accounting/bank/reconciliation/use_cases.rst

@@ -102,4 +102,4 @@ right and validate all related payments :
    :align: center
 
 .. seealso::
-   * :doc:`../feeds/bank_synchronization`
+   :doc:`../bank_synchronization`

content/applications/finance/accounting/bank/setup/bank_accounts.rst

@@ -4,7 +4,7 @@ Bank and cash accounts
 
 You can manage as many bank or cash accounts as needed on your database. Configuring them well
 allows you to have all your banking data up-to-date and ready for :doc:`reconciliation
-<../../bank/reconciliation/use_cases>` with your journal entries.
+<../reconciliation/use_cases>` with your journal entries.
 
 In Odoo Accounting, each bank account has a dedicated journal set to post all entries in a dedicated
 account. Both the journal and the account are automatically created and configured whenever you add
@@ -33,7 +33,7 @@ To connect your bank account to your database, go to :menuselection:`Accounting
 follow the instructions.
 
 .. seealso::
-   :doc:`../../bank/feeds/bank_synchronization`
+   :doc:`../bank_synchronization`
 
 Create a bank account
 ---------------------
@@ -83,7 +83,7 @@ You can edit the accounting information and bank account number according to you
 
 .. seealso::
    - :doc:`../../others/multi_currency`
-   - :doc:`../../bank/feeds/bank_statements`
+   - :doc:`../transactions`
    - :doc:`../../bank/setup/outstanding_accounts`
 
 Suspense account
@@ -132,5 +132,5 @@ Bank feeds
   with your database.
 
 .. seealso::
-   - :doc:`../../bank/feeds/bank_synchronization`
-   - :doc:`../../bank/feeds/bank_statements`
+   - :doc:`../bank_synchronization`
+   - :doc:`../transactions`

content/applications/finance/accounting/bank/transactions.rst

@@ -0,0 +1,46 @@
+============
+Transactions
+============
+
+Importing transactions from your bank statements allows keeping track of bank account transactions
+and reconciling them with the ones recorded in your accounting.
+
+:doc:`Bank synchronization <bank_synchronization>` automates the process. However, if you do not
+want to use it or if your bank is not yet supported, other options exist:
+
+- :ref:`Import bank transactions <import-statements>` delivered by your bank;
+- :ref:`Register bank transactions <register-transactions>` manually.
+
+.. _import-statements:
+
+Import transactions
+===================
+
+Odoo supports multiple file formats to import transactions:
+
+- SEPA recommended Cash Management format (CAMT.053);
+- Comma-separated values (.CSV);
+- Open Financial Exchange (.OFX);
+- Quicken Interchange Format (.QIF);
+- Belgium: Coded Statement of Account (.CODA).
+
+To import a file, go to the :guilabel:`Accounting Dashboard`, and in the :guilabel:`Bank` journal,
+click on :guilabel:`Import Transactions`.
+
+.. image:: transactions/import-transactions.png
+   :align: center
+   :alt: Import bank transactions from bank journal
+
+Next, select the file and upload it.
+
+After setting the necessary formatting options and mapping the needed columns, you can run a
+:guilabel:`Test` and :guilabel:`Import` your bank transactions.
+
+.. _register-transactions:
+
+Register bank transactions manually
+===================================
+
+You can also record your bank transactions manually. To do so, go to :guilabel:`Accounting
+Dashboard`, click on the :guilabel:`Bank` journal, and then on :guilabel:`New`. Make sure to fill
+out the :guilabel:`Partner` and :guilabel:`Label` fields to ease the reconciliation process.

content/applications/finance/accounting/getting_started/initial_configuration/setup.rst

@@ -55,7 +55,7 @@ Connect your bank account to your database and have your bank statements synced
 so, find your bank in the list, click on *Connect*, and follow the instructions on-screen.
 
 .. note::
-   :doc:`Click here <../../bank/feeds/bank_synchronization>` for more information about this feature.
+   :doc:`Click here <../../bank/bank_synchronization>` for more information about this feature.
 
 If your Bank Institution can’t be synchronized automatically, or if you prefer not to sync it with
 your database, you may also configure your bank account manually by clicking on *Create it*, and
@@ -188,6 +188,6 @@ Send yourself a sample invoice by email to make sure everything is correctly con
 .. seealso::
    * :doc:`../../bank/setup/bank_accounts`
    * :doc:`chart_of_accounts`
-   * :doc:`../../bank/feeds/bank_synchronization`
+   * :doc:`../../bank/bank_synchronization`
    * :doc:`../../../fiscal_localizations`
    * `Odoo Tutorials: Accounting Basics <https://www.odoo.com/r/lsZ>`_

content/applications/finance/accounting/others.rst

@@ -8,6 +8,6 @@ Others
    :titlesonly:
 
    others/multi_currency
-   others/analytic
+   others/analytic_accounting
    others/adviser
    others/inventory

content/applications/finance/accounting/others/analytic.rst

@@ -1,12 +0,0 @@
-:nosearch:
-
-========
-Analytic
-========
-
-.. toctree::
-   :titlesonly:
-
-   analytic/usage
-   analytic/timesheets
-   analytic/purchases_expenses

content/applications/finance/accounting/others/analytic/purchases_expenses.rst

@@ -1,147 +0,0 @@
-==================================================
-Track costs of purchases, expenses, subcontracting
-==================================================
-
-Overview
-========
-
-Thanks to analytical accounting we can track costs of purchases,
-expenses and subcontracting in the accounting module.
-
-We'll take the following example. We sold a consulting package for a
-customer. The package is all inclusive meaning no extra cost can be
-added. We would however like to follow which cost were attached to this
-transaction as we need to pay for purchases, expenses, and
-subcontracting costs related to the project.
-
-Configuration
-=============
-
-The following modules needs to be installed to track cost. Enter the app
-module and install the following apps:
-
-.. list-table::
-
-   - - .. image:: purchases_expenses/purchase01.png
-     - .. image:: purchases_expenses/purchase02.png
-     - .. image:: purchases_expenses/purchase03.png
-
-Please note that the applications provided by these apps only allows us
-to **track** the costs. We won't be able to automatically re invoice
-those costs to our customers. To track and **re invoice costs** you
-should install the Sales management app as well.
-
-.. image:: purchases_expenses/purchase04.png
-   :align: center
-
-Enable Analytical accounting
-----------------------------
-
-Next step is to activate the analytical accounting. In the accounting
-app, select :menuselection:`Configuration --> Settings` and thick the Analytic
-accounting box.
-
-.. image:: purchases_expenses/purchase05.png
-   :align: center
-
-Moreover, scroll down and tick the **Analytic accounting for purchases**
-box.
-
-.. image:: purchases_expenses/purchase06.png
-   :align: center
-
-Don't forget to save your changes.
-
-Create an Analytical account.
-=============================
-
-First of all you should create an Analytical account on which you can
-point all your expenses. Enter the accounting app, select
-:menuselection:`Configuration --> Analytic Accounts`. Create a new one. In this
-case we will call it "consulting pack" for our customer Smith&Co.
-
-.. image:: purchases_expenses/purchase07.png
-   :align: center
-
-We will point all our costs to this account to keep track of them.
-
-Record an expense
-=================
-
-We start by booking an expense. Our
-IT technician had to take a train to go see our customer. He paid for
-his ticket himself.
-
-Create an expense product
--------------------------
-
-We first need to create an expense product. Enter the **Expense** module,
-Click on :menuselection:`Configuration --> Expense Products`. Create a new product
-called Train ticket and set the cost price to 15.50 euros. Make sure the **Can be
-expensed** box is ticked.
-
-.. image:: purchases_expenses/purchase08.png
-   :align: center
-
-Book the expense
-----------------
-
-Enter the Expense module, click on :menuselection:`My expenses --> Create`. Select the
-Train ticket product and link it to the analytical account discussed
-above.
-
-.. image:: purchases_expenses/purchase09.png
-   :align: center
-
-Submit to manager and wait for the manager to approve and post the
-journal entries.
-
-Create a Purchase Order linked to the analytical account
-========================================================
-
-Purchase Product
-----------------
-
-We also need to buy a software for our customers. In the purchase app
-create a purchase order for the software product.
-Within the line we can link the product's cost with the analytical
-account. Specify the order line and select the correct analytical
-account. Confirm the sale.
-
-.. image:: purchases_expenses/purchase10.png
-   :align: center
-
-Accept the delivery and enter the invoice. Once the invoice is entered the cost
-price (**Vendor Price** field) will be booked in the analytical account.
-
-Subcontracting
---------------
-
-The purchase module can be used in the same way as seen previously to
-handle subcontracting. if we purchase a service from another company we
-can re invoice this cost by linking the purchase order line to the
-correct analytical account. We simply need to create the correct vendors
-product.
-
-.. note::
-   You can also track cost with timesheets, see: :doc:`timesheets`
-
-Track costs in accounting
-=========================
-
-Now that everything is booked and points to the analytical account.
-Simply open it to check the costs related to that account.
-
-Enter the accounting module, click on :menuselection:`Advisers --> Analytic Accounts
---> Open Charts`.
-
-Select "consulting pack - Smith" and click on the cost and revenue
-button to have an overview of all cost linked to the account.
-
-.. image:: purchases_expenses/purchase11.png
-   :align: center
-
-.. note::
-   If you would like to have the revenue as well you should
-   invoice the Consulting Pack in the Invoice menu and link the invoice
-   line to this same analytical account.

content/applications/finance/accounting/others/analytic/timesheets.rst

@@ -1,169 +0,0 @@
-==============================================
-Track costs of human resources with timesheets
-==============================================
-
-Human resource of course has a cost. It is interesting to see how much a
-particular contract costs the company in term of human power in relation
-to the invoiced amounts.
-
-We will take the following example: Our two employees **Harry Potter** and
-**Cedric Digory** both work on a **Consultancy pack** for our customer
-**Smith&Co**. Harry is paid 18€ p.h. and Cedric's salary is 12€ p.h. We
-would like to track their timesheet costs within the accounting app, and
-compare them with the revenue of the consultancy service.
-
-Configuration
-=============
-
-First, install the three applications necessary to use this
-functionality, namely **Accounting**, **Sales** and **Timesheet**. Enter the apps
-module name and install them.
-
-.. image:: timesheets/timesheets14.png
-   :align: center
-
-.. image:: timesheets/timesheets05.png
-   :align: center
-
-.. image:: timesheets/timesheets11.png
-   :align: center
-
-Next you will need to enable analytical accounting. To do so enter the
-**Accounting app**. Select :menuselection:`Configuration --> Settings` and tick the
-**Analytic accounting** option (see picture below)
-
-.. image:: timesheets/timesheets06.png
-   :align: center
-
-Apply your changes.
-
-Create an employee
-------------------
-
-In order to check the revenue of an employee you need to have one. To
-create an employee enter the **Employee** app. Select **Employees** and
-create a new employee, fill in the name and the basic information.
-
-On the employee sheet enter the **HR settings** tab. Here you are able to
-specify the **Timesheet Cost** of your employee. In this case Harry has a
-cost of 18 euros / hours. We will thus fill in 18 in this field.
-
-.. image:: timesheets/timesheets07.png
-   :align: center
-
-.. note::
-    If you want the employee to be able to enter timesheets he
-    needs to be related to a User.
-
-Repeat the operation to create the Cedric Digory employee. Don't forget
-to specify its related user and **Timesheet Costs**.
-
-Issue a Sales Order
--------------------
-
-We created two employees called Harry Potter and Cedric Diggory in the
-**Employee** app. Both of them will work on a consultancy contract for our
-customer Smith&Co where they will point their hours on a timesheet.
-
-We thus need to create a **sales order** with a **service** product invoiced
-**based on time and material** and tracked by timesheets with **hours** as unit
-of measures.
-
-.. image:: timesheets/timesheets03.png
-   :align: center
-
-For more information on how to create a sales order based on time and
-material please see :doc:`/applications/sales/sales/invoicing/time_materials`.
-
-We save a Sales Order with the service product **External Consulting**. An
-analytical account will automatically be generated once the **Sales Order**
-is confirmed. Our employees will have to point to that account (in this
-case **SO002-Smith&Co**) in order to be able to invoice their hours (see
-picture below).
-
-.. image:: timesheets/timesheets10.png
-   :align: center
-
-Fill in timesheet
------------------
-
-As an employee linked to a user, Harry can enter the **Timesheet** app and
-specify his timesheets for the contract. Logged on Harry's account we enter the
-**Timesheet** app and enter a detailed line pointing to the **Analytical
-Account** discussed above.
-
-Harry worked three hours on a SWOT analysis for Smith&Co.
-
-.. image:: timesheets/timesheets01.png
-   :align: center
-
-In the meantime, Cedric discussed businesses needs with the customer for
-1 hour and specified it as well in his personal timesheet, pointing as
-well on the **Analytic Account**.
-
-In the **Sales Order** we notice that the delivered amounts of hours is
-automatically computed (see picture below).
-
-.. image:: timesheets/timesheets02.png
-   :align: center
-
-Analytic accounting
--------------------
-
-Thanks to analytic accounts we are able to have an overview of HR cost
-and revenues. All the revenues and cost of this transactions have been
-registered in the **SO002-Smith&Co** account.
-
-We can use two methods to analyze this situation.
-
-Without filters
-~~~~~~~~~~~~~~~
-
-If we pointed all our costs and revenues of the project on the correct
-analytical account we can easily retrieve the cost and revenues related
-to this analytical account. Enter the *Accounting* app, select
-:menuselection:`Adviser --> Analytic Accounts --> Open Charts`.
-
-Note : you can specify a period for **Analysis**. If you want to open the
-current situation you should keep the fields empty. We can already note
-the credit and debit balance of the account.
-
-.. image:: timesheets/timesheets12.png
-   :align: center
-
-If we click on the account a special button is provided to have the
-details of cost and revenues (see picture below).
-
-.. image:: timesheets/timesheets13.png
-   :align: center
-
-Click the button **Cost/Revenue** to have an overview of cost and revenues with the
-corresponding description.
-
-With filters
-~~~~~~~~~~~~
-
-We can thus filter this information from the **Analytic Entries**.
-
-Enter the **Accounting** app, and click on :menuselection:`Adviser --> Analytic Entries`.
-In this menu we have several options to analyse the human resource cost.
-
-#. We filter on the **Analytic account** so we can see the cost and revenues
-   of the project. Add a custom **Filter** where the **Analytic Account**
-   contains the **Sales Order** number.
-
-   .. image:: timesheets/timesheets04.png
-      :align: center
-
-   In the results we see timesheets activities and invoiced lines with
-   the corresponding costs and revenues.
-
-   .. image:: timesheets/timesheets09.png
-     :align: center
-
-#. We can group the different analytical accounts together and check
-   their respective revenues. Simply group by **Analytic account** and
-   select the **Graph view** to have a clear overview.
-
-   .. image:: timesheets/timesheets08.png
-      :align: center

content/applications/finance/accounting/others/analytic/usage.rst

@@ -1,224 +0,0 @@
-==========================
-Analytic account use cases
-==========================
-
-The analytic accounting can be used for several purposes:
-
--  analyse costs of a company
-
--  reinvoice time to a customer
-
--  analyse performance of a service or a project
-
-To manage analytic accounting, you have to activate it in
-:menuselection:`Configuration --> Settings`:
-
-.. image:: usage/usage01.png
-   :align: center
-
-To illustrate analytic accounts clearly, you will follow three use
-cases, each in one of three different types of company:
-
-1. Industrial company: Costs Analyse
-
-2. Law Firm: reinvoice spent hours
-
-3. IT/Services Company: performance analysis
-
-Case 1: Industrial company: Costs Analyse
------------------------------------------
-
-In industry, you will often find analytic charts of accounts structured
-into departments and products the company itself is built on.
-
-The objective is to examine the costs, sales and margins by
-department/resources and by product. The first level of the structure
-comprises the different departments, and the lower levels represent the
-product ranges the company makes and sells.
-
-**Analytic Chart of Accounts for an Industrial Manufacturing Company**:
-
-1. Marketing Department
-
-2. Commercial Department
-
-3. Administration Department
-
-4. Production Range 1
-
-5. Production Range 2
-
-In daily use, it is useful to mark the analytic account on each purchase
-invoice. When the invoice is approved, it will
-automatically generate the entries for both the general and the
-corresponding analytic accounts. For each entry on the general
-accounts, there is at least one analytic entry that allocates costs to
-the department which incurred them.
-
-Here is a possible breakdown of some general accounting entries for the
-example above, allocated to various analytic accounts:
-
-+---------------------------------------+-----------+---------+----------+----+-------------------------+----------+
-| **General accounts**                  |           |         |          |    | **Analytic accounts**   |          |
-+=======================================+===========+=========+==========+====+=========================+==========+
-| **Title**                             |**Account**|**Debit**|**Credit**|    | **Account**             |**Value** |
-+---------------------------------------+-----------+---------+----------+----+-------------------------+----------+
-| Purchase of Raw Material              | 2122      | 1500    |          |    | Production Range 1      | -1 500   |
-+---------------------------------------+-----------+---------+----------+----+-------------------------+----------+
-| Subcontractors                        | 2122      | 450     |          |    | Production Range 2      | -450     |
-+---------------------------------------+-----------+---------+----------+----+-------------------------+----------+
-| Credit Note for defective materials   | 2122      |         | 200      |    | Production Range 1      | 200      |
-+---------------------------------------+-----------+---------+----------+----+-------------------------+----------+
-| Transport charges                     | 2122      | 450     |          |    | Production Range 1      | -450     |
-+---------------------------------------+-----------+---------+----------+----+-------------------------+----------+
-| Staff costs                           | 2121      | 10000   |          |    | Marketing               | -2 000   |
-+---------------------------------------+-----------+---------+----------+----+-------------------------+----------+
-|                                       |           |         |          |    | Commercial              | -3 000   |
-+---------------------------------------+-----------+---------+----------+----+-------------------------+----------+
-|                                       |           |         |          |    | Administrative          | -1 000   |
-+---------------------------------------+-----------+---------+----------+----+-------------------------+----------+
-|                                       |           |         |          |    | Production Range 1      | -2 000   |
-+---------------------------------------+-----------+---------+----------+----+-------------------------+----------+
-|                                       |           |         |          |    | Production Range 2      | -2 000   |
-+---------------------------------------+-----------+---------+----------+----+-------------------------+----------+
-| PR                                    | 2122      | 450     |          |    | Marketing               | -400     |
-+---------------------------------------+-----------+---------+----------+----+-------------------------+----------+
-
-The analytic representation by department enables you to investigate the
-costs allocated to each department in the company. The analytic chart of
-accounts shows the distribution of the company's costs using the example above:
-
-.. image:: usage/usage02.png
-   :align: center
-
-In this example of a hierarchical structure in Odoo, you can analyse not
-only the costs of each product range, but also the costs of the whole
-production. A report that relates both general accounts and analytic
-accounts enables you to get a breakdown of costs within a given
-department.
-
-.. image:: usage/usage03.png
-   :align: center
-
-The examples above are based on a breakdown of the costs of the company.
-Analytic allocations can be just as effective for sales. That gives you
-the profitability (sales - costs) of different departments.
-
-This analytic representation by department is generally used by trading
-companies and industries.
-
-A variantion of this, is not to break it down by sales and marketing
-departments, but to assign each cost to its corresponding product range.
-This will give you an analysis of the profitability of each product
-range.
-
-Choosing one over the other depends on how you look at your marketing
-effort. Is it a global cost allocated in some general way, or is each
-product range responsible for its own marketing costs?
-
-Case 2: Law Firm: costs of human resources?
--------------------------------------------
-
-Law firms generally adopt management by case, where each case represents
-a current client file. All of the expenses and products are then
-attached to a given file/analytic account.
-
-A principal preoccupation of law firms is the invoicing of hours worked,
-and the profitability by case and by employee.
-
-Mechanisms used for encoding the hours worked will be covered in detail
-in timesheet documentation. Like most system processes, hours worked are
-integrated into the analytic accounting. In the employee form, specify
-the cost of the employee. The hourly charge is a function of the
-employee's cost.
-
-So a law firm will opt for an analytic representation which reflects the
-management of the time that employees work on the different customer
-cases.
-
-Billing for the different cases is a bit unusual. The cases do not match
-any entry in the general account nor do they come from purchase or sales
-invoices. They are represented by the various analytic operations and do
-not have exact counterparts in the general accounts. They are calculated
-on the basis of the hourly cost per employee.
-
-At the end of the month when you pay salaries and benefits, you
-integrate them into the general accounts but not in the analytic
-accounts, because they have already been accounted for in billing each
-account. A report that relates data from the analytic and general
-accounts then lets you compare the totals, so you can readjust your
-estimates of hourly cost per employee depending on the time actually
-worked.
-
-The following table shows an example of different analytic entries that
-you can find for your analytic account:
-
-+--------------------------------+------------------+--------------+----+----------------------------+-------------+--------------+
-| **Title**                      | **Account**      | **Amount**   |    | **General Account**        | **Debit**   | **Credit**   |
-+================================+==================+==============+====+============================+=============+==============+
-| Study the file (1 h)           | Case 1.1         | -15          |    |                            |             |              |
-+--------------------------------+------------------+--------------+----+----------------------------+-------------+--------------+
-| Search for information (3 h)   | Case 1.1         | -45          |    |                            |             |              |
-+--------------------------------+------------------+--------------+----+----------------------------+-------------+--------------+
-| Consultation (4 h)             | Case 2.1         | -60          |    |                            |             |              |
-+--------------------------------+------------------+--------------+----+----------------------------+-------------+--------------+
-| Service charges                | Case 1.1         | 280          |    | 705 – Billing services     |             | 280          |
-+--------------------------------+------------------+--------------+----+----------------------------+-------------+--------------+
-| Stationery purchase            | Administrative   | -42          |    | 601 – Furniture purchase   | 42          |              |
-+--------------------------------+------------------+--------------+----+----------------------------+-------------+--------------+
-| Fuel Cost -Client trip         | Case 1.1         | -35          |    | 613 – Transports           | 35          |              |
-+--------------------------------+------------------+--------------+----+----------------------------+-------------+--------------+
-| Staff salaries                 |                  |              |    | 6201 – Salaries            |             | 3 000        |
-+--------------------------------+------------------+--------------+----+----------------------------+-------------+--------------+
-
-Such a structure allows you to make a detailed study of the
-profitability of various transactions.
-
-For more details about profitablity, please read the following document:
-:doc:`timesheets`
-
-But analytical accounting is not limited to a simple analysis of the
-profitability of different customer. The same data can be used for
-automatic recharging of the services to the customer at the end of the
-month. To invoice customers, just link the analytic account to a sale
-order and sell products that manage timesheet or expenses .
-
-Case 3: IT Services Company: performance analysis
--------------------------------------------------
-
-Most IT service companies face the following problems:
-
--  project planning,
-
--  invoicing, profitability and financial follow-up of projects,
-
--  managing support contracts.
-
-To deal with these problems, you would use an analytic chart of accounts
-structured by project and by sale order.
-
-The management of services, expenditures and sales is similar to that
-presented above for lawyers. Invoicing and the study of profitability
-are also similar.
-
-But now look at support contracts. These contracts are usually limited
-to a prepaid number of hours. Each service posted in the analytic
-accounts shows the remaining hours of support. To manage support
-contracts, you would create a product configured to invoice on order and
-link the sale order to an analytic account
-
-In Odoo, each analytic line lists the number of units sold or used, as
-well as what you would usually find there – the amount in currency units
-(USD or GBP, or whatever other choice you make). So you can sum the
-quantities sold and used on each sale order to determine whether any
-hours of the support contract remain.
-
-Conclusion
-----------
-
-Analytic accounting helps you to analyse costs and revenues whatever the
-use case. You can sell or purchase services, track time or analyse the
-production performance.
-
-Analytic accounting is flexible and easy to use through all Odoo
-applications (sales, purchase, timesheet, production, invoice, …).

content/applications/finance/accounting/others/analytic_accounting.rst

@@ -0,0 +1,131 @@
+===================
+Analytic accounting
+===================
+
+Analytic accounting helps you track costs and revenues, as well as analyze the profitability of a
+project or service. When creating your journal entries, the analytic widget allows the distribution
+of costs in one or more analytic accounts.
+
+Configuration
+=============
+
+Enable the :guilabel:`Analytic Accounting` feature by going to :menuselection:`Accounting -->
+Configuration --> Settings --> Analytics`.
+
+Analytic accounts
+=================
+
+The analytic accounts give an overview of your costs and revenue.
+
+Access your existing analytic accounts by going to :menuselection:`Accounting --> Configuration -->
+Analytic Accounting: Analytic Accounts`. To create a new analytic account, click :guilabel:`New`,
+and fill in the required information:
+
+- :guilabel:`Analytic Account`: add the name of your analytic account;
+- :guilabel:`Customer`: select the customer related to your project;
+- :guilabel:`Reference`: add a reference to make it easier to find the account when you are on your
+  bill;
+- :guilabel:`Plan`: add an :ref:`analytic plan <analytic_accounting/analytic_plans>`;
+- :guilabel:`Company`: if you are managing multiple companies, select the company for which the
+  analytic account will be used;
+- :guilabel:`Currency`: select the currency of the analytic account;
+
+Then, fill in your :doc:`budget <adviser/budget>` information.
+
+.. _analytic_accounting/analytic_plans:
+
+Analytic plans
+==============
+
+The analytic plans allow you to analyze your accounting. For example, to track costs and revenues by
+project or department.
+
+You can access the analytic plans by going to :menuselection:`Accounting --> Configuration -->
+Analytic Accounting: Analytic Plans`. Click :guilabel:`New` to create a new plan.
+
+.. image:: analytic_accounting/analytic_plans.png
+   :align: center
+   :alt: create an analytic plan
+
+The following information must be completed:
+
+- :guilabel:`Parent`: link your plan to another :guilabel:`Analytic Plan` to build a hierarchy
+  between your plans;
+- :guilabel:`Default Applicability`: decide how your plan behaves in the widget when creating a new
+  journal entry:
+
+   - :guilabel:`Optional`: if selected, it is not mandatory to add the analytic plan in the widget;
+   - :guilabel:`Mandatory`: if selected, an orange bullet is visible in the widget next to the plan
+     until the analytic distribution is done (the bullet then turns to green); it is not possible to
+     confirm the entry if no analytic account is selected;
+   - :guilabel:`Unavailable`: if selected, the plan is not available in the widget.
+
+- :guilabel:`Color`: select the color of the tag related to this specific plan;
+- :guilabel:`Company`: add the company to which the plan applies;
+
+You can also fine-tune your plans' applicability by filling in the :guilabel:`Applicability` tab:
+
+- :guilabel:`Domain`: choose to which accounting document your plan applies;
+- :guilabel:`Financial Accounts Prefix`: select the prefix of the account(s) to which this plan
+  should be applied;
+- :guilabel:`Product Category`: decide to which product category the plan applies;
+- :guilabel:`Applicability`: decide how your plan behaves in the widget when creating a new journal
+   entry. The applicability you set here always overrides the default applicability.
+
+Two smart buttons are available in the top-right corner:
+
+   - :guilabel:`Subplans`: can be created to have a more complex analytic structure. Click the
+     :guilabel:`Subplans` smart button, and then :guilabel:`New` to add a subplan;
+   - :guilabel:`Analytic Accounts`: to reach the analytic accounts related to the plan.
+
+.. note::
+   - The analytic widget is prefilled based on the applicability, and the
+     :ref:`Analytic Distribution Models <analytic_distribution_models>`;
+   - Each analytic plan must have at least one analytic account.
+
+Analytic distribution
+=====================
+
+Add a plan in the :guilabel:`Analytic` column when creating an invoice or bill. This field is
+mandatory only if you previously linked your analytic plan to at least one analytic account. After
+adding the plan, a **widget** opens where you can fill in the different information. You can add
+**tags** to reflect the related analytic accounts and decide how to split the costs between the
+accounts by modifying the percentage.
+
+.. image:: analytic_accounting/analytic_distribution.png
+   :align: center
+   :alt: create a distribution template
+
+.. _analytic_distribution_models:
+
+Analytic distribution models
+----------------------------
+
+The analytic distribution models automatically apply a specific distribution based on defined
+criteria.
+
+To create a new analytic distribution model, go to :menuselection:`Accounting --> Configuration -->
+Analytic Distribution Models`, click :guilabel:`New` and set the conditions your model has to meet
+to automatically apply:
+
+- :guilabel:`Accounts Prefix`: this analytic distribution will apply to all financial accounts
+  sharing the prefix specified;
+- :guilabel:`Partner`: select a partner for which the analytic distribution will be used;
+- :guilabel:`Partner Category`: this field is not visible by default: add it by clicking on the
+  columns selection button, and tick the :guilabel:`Partner Category` box. Add the partner category
+  for which the analytic distribution will be used;
+- :guilabel:`Product`: select a product for which the analytic distribution will be used;
+- :guilabel:`Product Category`: this field is not visible by default: add it by clicking on the
+  columns selection button, and tick the :guilabel:`Product Category` box. Select a product category
+  for which the analytic distribution will be used;
+- :guilabel:`Analytic`: add the analytic accounts and their distribution;
+- :guilabel:`Company`: select a company for which the analytic distribution will be used;
+- :guilabel:`Analytic Distribution`: if the above conditions are met, the :guilabel:`Analytic plan`
+  defined in this field as well as the distribution to be applied between the different analytic
+  accounts is selected automatically on the entry.
+
+.. tip::
+   To **mass edit** several entries simultaneously, go to :menuselection:`Accounting --> Accounting
+   --> Journal items`, and select the ones that need to be updated. Add the required distribution in
+   the :guilabel:`Analytic Distribution` column, and click on the :guilabel:`floppy disk` icon to
+   save. The analytic distribution template pops up, and you can save it for later use.

content/applications/finance/accounting/payables/pay.rst

@@ -10,3 +10,4 @@ Vendor payments
    pay/sepa
    pay/check
    pay/multiple
+   pay/trusted_accounts

content/applications/finance/accounting/payables/pay/trusted_accounts.rst

@@ -0,0 +1,61 @@
+=============================
+Trusted accounts (send money)
+=============================
+
+To protect users from sending money to scammers, vendor bank account numbers must be marked as
+trusted before you can use them to make an outgoing payment.
+
+To do so, open the vendor bank account and click on the :guilabel:`Send Money` toggle switch button.
+
+.. image:: trusted_accounts/send-money-toggle.png
+   :align: center
+   :alt: Example of a vendor bank account with the "Send Money" toggle button switched to "trusted."
+
+.. note::
+   All accounts are initially marked as untrusted.
+
+Phishing attacks
+================
+
+A **phishing attack** is an online scam designed to trick individuals or companies into giving away
+sensitive information or money by sending out fraudulent communication. Fraudsters pretend to be
+legitimate companies and may use partial information to give credibility to their requests.
+
+There are several types of phishing attacks, including **invoice fraud**. In this case, the
+fraudster pretends to be a genuine supplier following up on unpaid bills or sending a new invoice,
+but with different payment information than usual and with fake contact details.
+
+To protect yourself from these types of phishing attacks, remain vigilant when you receive
+unexpected invoices or payment requests.
+
+.. important::
+   In case of doubt, **we recommend contacting the vendor by phone**. Make sure to call an official
+   phone number by searching yourself, as the URLs, email addresses, and phone numbers written in
+   the communication you received may be fake.
+
+Elements to check
+-----------------
+
+There are several elements you can check by yourself when you receive an outgoing payment request to
+a new account:
+
+Communication style
+  Fraudulent emails and invoices often use a different communication style, such as **different
+  wording**, and may include **spelling and grammatical mistakes**. Examine and **compare** them
+  with previous ones that you know to be authentic (e.g., payment instructions, language, company
+  logo, etc.).*
+
+Urgency
+  Invoice frauds often use **urgent or threatening language** and change the **payment deadline**.
+  Check if you really received a late payment reminder previously.
+
+Type of account
+  A company is unlikely to replace a bank account with a **money transfer service**.
+
+Email and links domain names
+  Double-check the **email address domain** (`example@domain.com`). However, be wary that fraudsters
+  can make their email addresses look genuine or even hack email addresses from your vendor's
+  employees or even someone within your own organization.
+
+  Hover over the links in your email and check that the URLs they redirect to are genuine. Your
+  internet browser usually displays the link's target at the bottom left of the window.

content/applications/finance/accounting/receivables/customer_payments/recording.rst

@@ -13,7 +13,7 @@ your company, or your company has an outstanding debit with a vendor. You can us
 amounts to reduce unpaid invoices/bills.
 
 .. seealso::
-   - :doc:`Internal transfers <../../bank/misc/interbank>`
+   - :doc:`Internal transfers <../../bank/interbank>`
    - :doc:`../../bank/reconciliation/use_cases`
    - `Odoo Tutorials: Bank Configuration
      <https://www.odoo.com/slides/slide/bank-configuration-1880>`_

content/applications/finance/accounting/reporting/declarations/intrastat.rst

@@ -2,27 +2,229 @@
 Intrastat
 =========
 
-**Intrastat** is the system for data collection and statistic production of goods traded among the
-EU Member States. Organizations whose annual trade surpasses a certain threshold must provide data
-about the goods traded with other EU countries.
+Intrastat is the data collection and statistics production system for goods traded among EU member
+states. It collects data on:
 
-.. seealso::
-   - `Eurostat Statistics Explained - Glossary: Intrastat
-     <https://ec.europa.eu/eurostat/statistics-explained/index.php?title=Glossary:Intrastat>`_
+- Commercial transactions of goods for use, consumption, investment, or resale with ownership
+  transfer;
+- Goods movements without transfer of ownership (e.g., stock relocations or moves of goods
+  before or after outsourced production or processing, and after maintenance or repair);
+- Returns of goods.
 
 .. note::
-   As of January 1, 2022, the reporting requirements have changed. One main modification concerns
-   the transaction codes which are now switching to a 2-digits format. All transactions recorded
-   after this date have to follow the new system’s rules.
+   Although the Intrastat system continues to be used, the term Intrastat is not used in the `latest
+   legislation <http://data.europa.eu/eli/reg/2019/2152/2022-01-01>`_, referring instead to
+   *intra-Union trade in goods statistics*.
 
-Configuration
-=============
+.. seealso::
+   `Eurostat Statistics Explained - Glossary: Intrastat
+   <https://ec.europa.eu/eurostat/statistics-explained/index.php?title=Glossary:Intrastat>`_
 
-Go to :menuselection:`Accounting --> Settings --> Customer Invoices`, then enable **Intrastat** and
-*Save*. Once the Intrastat has been activated you are able to choose the **Default incoterm**.
+.. _intrastat/general-configuration:
+
+General configuration
+=====================
+
+Enable the Intrastat report by going to :menuselection:`Accounting --> Configuration --> Settings`.
+Under the :guilabel:`Customer Invoices` section, tick :guilabel:`Intrastat` and then
+:guilabel:`Save`.
 
 .. important::
-   If you created your Odoo database prior to **January 13, 2022**, please :ref:`upgrade
-   <general/upgrade>` the ``account_intrastat`` module to add the new transaction codes and
-   :ref:`install <general/install>` the ``account_intrastat_expiry`` module to archive the old
-   codes.
+   If your Odoo database was created before **January 13, 2022**, first :ref:`upgrade
+   <general/upgrade>` the `account_intrastat` module to add the new transaction codes and
+   :ref:`install <general/install>` the `account_intrastat_expiry` module to archive the old codes.
+
+.. _intrastat/default-transaction-codes:
+
+Default transaction codes: invoice and refund
+---------------------------------------------
+
+You can set a default :ref:`transaction code <intrastat/transaction-code>` for all newly created
+invoice and refund transactions. Under :menuselection:`Accounting --> Configuration --> Settings`,
+select a :guilabel:`Default invoice transaction code` and/or a :guilabel:`Default refund transaction
+code` and then :guilabel:`Save`. The code will be set automatically on all respective invoice lines.
+
+.. _intrastat/default-incoterm:
+
+Default Incoterm rule
+---------------------
+
+You can set a default :ref:`Incoterm rule <intrastat/incoterm>` to automatically populate the
+Incoterm field on all newly created invoices and bills. Under :menuselection:`Accounting -->
+Configuration --> Settings`, select the company's :guilabel:`Default Incoterm` and then
+:guilabel:`Save`.
+
+.. _intrastat/region-code:
+
+Region code
+-----------
+
+The region code is **only used by Belgian companies**. Under :menuselection:`Accounting -->
+Configuration --> Settings`, select the :guilabel:`Company Intrastat Region` where the company is
+located and then :guilabel:`Save`.
+
+.. tip::
+   If your warehouses are located in more than one region, you can define the region code at the
+   level of each warehouse instead. To do so, go to :menuselection:`Inventory --> Configuration -->
+   Warehouses`, select a warehouse, set its :guilabel:`Intrastat region`, and then :guilabel:`Save`.
+
+   .. image:: intrastat/warehouse-region.png
+      :align: center
+      :alt: Adding the Intrastat region to a warehouse
+
+.. _intrastat/product-configuration:
+
+Product configuration
+=====================
+
+All products must be properly configured to be included in the Intrastat report.
+
+.. _intrastat/commodity-code:
+
+Commodity code
+--------------
+
+Commodity codes are internationally recognized reference numbers used to classify goods depending on
+their **nature**. Intrastat uses the `Combined Nomenclature <https://taxation-customs.ec.europa.eu/customs-4/calculation-customs-duties/customs-tariff/combined-nomenclature_en>`_.
+
+To add a commodity code, go to :menuselection:`Accounting --> Customers --> Products` and select a
+product. Under the :guilabel:`Accounting` tab, set the product's :guilabel:`Commodity Code`.
+
+.. seealso::
+   `National Bank of Belgium - Intrastat commodity codes
+   <https://www.nbb.be/en/statistics/foreign-trade/nomenclature-and-codes>`_
+
+.. _intrastat/quantity:
+
+Quantity: weight and supplementary unit
+---------------------------------------
+
+Depending on the nature of the goods, it is necessary to specify either the product's weight in
+kilos (without packaging) or the product's supplementary unit, such as square meter (`m2`), number
+of items (`p/st`), liter (`l`), or gram (`g`).
+
+To add a product's weight or supplementary unit, go to :menuselection:`Accounting --> Customers -->
+Products` and select a product. Under the :guilabel:`Accounting` tab, depending on the commodity
+code set, either fill in the product :guilabel:`Weight` or its :guilabel:`Supplementary Units`.
+
+.. _intrastat/origin-country:
+
+Country of origin
+-----------------
+
+To add the product's country of origin, go to :menuselection:`Accounting --> Customers --> Products`
+and select a product. Under the :guilabel:`Accounting` tab, set the :guilabel:`Country of Origin`.
+
+.. _intrastat/invoice-bill-configuration:
+
+Invoices and bills configuration
+================================
+
+Once products are properly configured, several settings must be configured on the invoices and bills
+you create.
+
+.. _intrastat/transaction-code:
+
+Transaction code
+----------------
+
+Transaction codes are used to identify a transaction's nature. :ref:`Default transaction codes
+<intrastat/default-transaction-codes>` can be set for invoice and refund transactions.
+
+To set a transaction code on an invoice line, create an invoice or a bill, click the columns
+selection button, tick :guilabel:`Intrastat`, and use the newly-added :guilabel:`Intrastat` column
+to select a transaction code.
+
+.. image:: intrastat/intrastat-column.png
+   :align: center
+   :alt: Adding the Intrastat column to an invoice or bill
+
+.. seealso::
+   `National Bank of Belgium - Intrastat: Nature of transactions from January 2022
+   <https://www.nbb.be/doc/dd/onegate/data/new_natures_of_transaction_2022_en.pdf>`_
+
+.. _intrastat/incoterm:
+
+Incoterm rule
+-------------
+
+Incoterms are 11 internationally recognized rules defining the responsibilities of sellers and
+buyers, specifying who is responsible for paying and managing the shipment, insurance,
+documentation, customs clearance, and other logistical activities. A :ref:`default Incoterm
+<intrastat/default-incoterm>` can be set for all invoices and bills.
+
+To set the Incoterm manually, create an invoice or a bill, click the :guilabel:`Other Info` tab, and
+select the :guilabel:`Incoterm`.
+
+.. seealso::
+   `Wikipedia: Incoterms <https://en.wikipedia.org/wiki/Incoterms>`_
+
+.. _intrastat/partner-country:
+
+Partner country
+---------------
+
+The partner country represents the vendor's country for bills and the customer's country for
+invoices. It is automatically filled in using the country set in the contact's :guilabel:`Country`
+field.
+
+To edit the partner country manually, create an invoice or a bill, click the :guilabel:`Other Info`
+tab, and select the :guilabel:`Intrastat Country`.
+
+.. _intrastat/transport-code:
+
+Transport code
+--------------
+
+The transport code identifies the presumed **mode of transport** used to send the goods (arrival or
+dispatch).
+
+To add the transport code, create an invoice or a bill, go to the :guilabel:`Other info` tab,
+and select the :guilabel:`Intrastat Transport Mode`.
+
+.. _intrastat/value:
+
+Value of the goods
+------------------
+
+The value of a good is the untaxed :guilabel:`Subtotal` (:guilabel:`Price` multiplied by
+:guilabel:`Quantity`) of an invoice line.
+
+.. _intrastat/partner:
+
+Partner configuration
+=====================
+
+Two fields from the partner's contact form are used with Intrastat: :guilabel:`VAT` and
+:guilabel:`Country`. The country can be :ref:`manually set <intrastat/partner-country>` on the
+invoice or bill.
+
+Generate the Intrastat report
+=============================
+
+Generate the report by going to :menuselection:`Accounting --> Reporting --> Audit Reports:
+Intrastat Report`. It is automatically computed based on the :ref:`default configuration
+<intrastat/general-configuration>` and the information found on the :ref:`products
+<intrastat/product-configuration>`, :ref:`invoices and bills
+<intrastat/invoice-bill-configuration>`, and :ref:`partners <intrastat/partner>`.
+
+Export the report as a PDF, XLSX, or XML file to post it to your legal administration.
+
+Each report line refers to a single invoice line and contains the following information:
+
+- Invoice or bill reference number;
+- System, which is a code automatically generated depending on whether the document is an invoice
+  (dispatch) or a bill (arrival);
+- :ref:`Country <intrastat/partner-country>`, which is the vendor's country for arrivals and the
+  customer's country for dispatches;
+- :ref:`Transaction Code <intrastat/transaction-code>`;
+- (If your company is located in Belgium) :ref:`Region Code <intrastat/region-code>`;
+- :ref:`Commodity Code <intrastat/commodity-code>`;
+- :ref:`Origin Country <intrastat/origin-country>`;
+- :ref:`Partner VAT <intrastat/partner>`;
+- :ref:`Transport Code <intrastat/transport-code>`;
+- :ref:`Incoterm Code <intrastat/incoterm>`;
+- :ref:`Weight <intrastat/quantity>`;
+- :ref:`Supplementary Units <intrastat/quantity>`; and
+- :ref:`Value <intrastat/value>`, which is always expressed in euros even if the original invoice or
+  bill used another currency.