[IMP] accounting: move in-odoo to top-level TOC page + imp structure

This commit is part of a larger work to improve the documentation's
structure. The toctree structure used to add levels to create categories
and make the structure visually more understandable.
With the new version of the documentation, plenty of these categories
are now redundant.

This commit improves the structure of the "Accounting" app:
- it moves the doc "in-odoo" in the top "app" level and its content is
  included in "accounting.rst" (the content will later be improved)

  - adds new intro
  - changes external links to mementos to correct doc references

- it renames the category accounting/overview to
  accounting/getting_started
- it renames the category accounting/overview/getting_started to
  accounting/getting_started/initial_configuration
- it moves "memento" one level above, from
  accounting/overview/main_concepts to the renamed
  accounting/getting_started as it is the last doc remaining in this
  category
- it renames the app "Invoicing and Accounting" to
  "Accounting and Invoicing" since the focus should be on "Accounting"

task-2535899
This commit is contained in:
Jonathan Castillo
2021-05-20 16:10:22 +02:00
committed by Antoine Vandevenne (anv)
parent 7f3b2a1edd
commit d66de0d1f2
50 changed files with 190 additions and 181 deletions
@@ -0,0 +1,174 @@
=================
Chart of Accounts
=================
The **Chart of Accounts (COA)** is the list of all the accounts used to record financial
transactions in the general ledger of an organization.
The accounts are usually listed in the order of appearance in the financial reports. Most of the
time, they are listed as follows :
- Balance Sheet accounts
* Assets
* Liabilities
* Equity
- Profit & Loss
* Income
* Expense
When browsing your Chart of Accounts, you can filter the accounts by number, in the left column, and
also group them by Account Type.
.. image:: media/chart_of_accounts01.png
:align: center
:alt: Group the accounts by type in Odoo Accounting
Configuration of an Account
===========================
The country you select at the creation of your database (or additional company on your database)
determines which **Fiscal Localization Package** is installed by default. This package includes a
standard Chart of Accounts already configured according to the country's regulations. You can use
it directly or set it according to your company's needs.
.. warning::
It is not possible to modify the **Fiscal Localization** of a company once a Journal Entry has
been posted.
To create a new account, go to :menuselection:`Accounting --> Configuration --> Chart of Accounts`,
click on *Create*, and fill out the form.
Code and Name
-------------
Each account is identified by its **Code** and **Name**, which also indicates the account's purpose.
Type
----
Configuring correctly the **Account Type** is critical as it serves multiple purposes:
- Information on the account's purpose and behavior
- Generate country-specific legal and financial reports
- Set the rules to close a fiscal year
- Generate opening entries
To configure an account type, open the **Type** field's drop-down selector and select the right
type among the following list:
+---------------+--------------+-------------------------+
| Report | Category | Account Types |
+===============+==============+=========================+
| Balance Sheet | Assets | Receivable |
| | +-------------------------+
| | | Bank and Cash |
| | +-------------------------+
| | | Current Assets |
| | +-------------------------+
| | | Non-current Assets |
| | +-------------------------+
| | | Prepayments |
| | +-------------------------+
| | | Fixed Assets |
| +--------------+-------------------------+
| | Liabilities | Payable |
| | +-------------------------+
| | | Credit Card |
| | +-------------------------+
| | | Current Liabilities |
| | +-------------------------+
| | | Non-current Liabilities |
| +--------------+-------------------------+
| | Equity | Equity |
| | +-------------------------+
| | | Current Year Earnings |
+---------------+--------------+-------------------------+
| Profit & Loss | Income | Income |
| | +-------------------------+
| | | Other Income |
| +--------------+-------------------------+
| | Expense | Expense |
| | +-------------------------+
| | | Depreciation |
| | +-------------------------+
| | | Cost of Revenue |
+---------------+--------------+-------------------------+
|Other | Other | Off-Balance Sheet |
+---------------+--------------+-------------------------+
Assets, Deferred Expenses, and Deferred Revenues Automation
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Some Account Types display a new field **to automate** the creation of :ref:`Assets
<assets-automation>` entries, :ref:`Deferred Expenses <deferred-expenses-automation>` entries,
and :ref:`Deferred Revenues <deferred-revenues-automation>` entries.
You have three choices for the **Automation** field:
#. **No:** this is the default value. Nothing happens.
#. **Create in draft:** whenever a transaction is posted on the account, a draft entry is created,
but not validated. You must first fill out the corresponding form.
#. **Create and validate:** you must also select a Model. Whenever a transaction is posted on the
account, an entry is created and immediately validated.
.. note::
Please refer to the related documentation for more information.
Default Taxes
-------------
Select a **default tax** that will be applied when this account is chosen for a product sale or
purchase.
Tags
----
Some accounting reports require **tags** to be set on the relevant accounts. By default, you can
choose among the tags that are used by the *Cash Flow Statement*.
Account Groups
--------------
**Account Groups** are useful to list multiple accounts as *sub-accounts* of a bigger account and
thus consolidate reports such as the **Trial Balance**.
To create a new Account Group, open the account you want to configure as sub-account, click on the
*Group* drop-down selector, select *Create and Edit...*, fill out the form, and save. Next,
set all the sub-accounts with the right Account Group.
To display your **Trial Balance** report with your Account Groups, go to :menuselection:`Accounting
--> Reporting --> Trial Balance`, then open the *Options* menu and select **Hierarchy and
Subtotals**.
.. image:: media/chart_of_accounts02.png
:align: center
:alt: Account Groups in the Trial Balance in Odoo Accounting
Allow Reconciliation
--------------------
Some accounts, such as accounts made to record the transactions of a payment method, can be used for
the reconciliation of journal entries.
For example, an invoice paid with a credit card can be *marked as paid* if reconciled with the
payment. Therefore, the account used to record credit card payments needs to be configured as
*allowing reconciliation*.
To do so, check the **Allow Reconciliation** box and save.
Deprecated
----------
It is not possible to delete an account once a transaction has been recorded on it. You can make
them unusable by using the **Deprecated** feature.
To do so, check the **Deprecated** box and save.
.. seealso::
* :doc:`../../payables/supplier_bills/assets`
* :doc:`../../payables/supplier_bills/deferred_expenses`
* :doc:`../../receivables/customer_invoices/deferred_revenues`
* :doc:`../../fiscal_localizations/overview/fiscal_localization_packages`
Binary file not shown.

After

Width:  |  Height:  |  Size: 20 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 22 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 20 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 32 KiB

@@ -0,0 +1,194 @@
===================================================
Initial setup of Odoo Accounting and Odoo Invoicing
===================================================
When you first open your Odoo Accounting app, the *Accounting Overview* page welcomes you with a
step-by-step onboarding banner, a wizard that helps you get started. This onboarding banner is
displayed until you choose to close it.
The settings visible in the onboarding banner can still be modified later by going to
:menuselection:`Accounting --> Configuration --> Settings`.
.. note::
Odoo Accounting automatically installs the appropriate **Fiscal Localization Package** for your
company, according to the country selected at the creation of the database. This way, the right
accounts, reports, and taxes are ready-to-go. :doc:`Click here
<../../fiscal_localizations/overview/fiscal_localization_packages>` for more information about
Fiscal Localization Packages.
Accounting onboarding banner
============================
The step-by-step Accounting onboarding banner is composed of four steps:
.. image:: media/setup_accounting_onboarding.png
:align: center
:alt: Step-by-step onboarding banner in Odoo Accounting
#. :ref:`accounting-setup-company`
#. :ref:`accounting-setup-bank`
#. :ref:`accounting-setup-periods`
#. :ref:`accounting-setup-chart`
.. _accounting-setup-company:
Company Data
------------
This menu allows you to add your companys details such as the name, address, logo, website, phone
number, email address, and Tax ID, or VAT number. These details are then displayed on your documents,
such as on invoices.
.. image:: media/setup_company.png
:align: center
:alt: Add your company's details in Odoo Accounting and Odoo Invoicing
.. note::
You can also change these settings by going to :menuselection:`Settings --> General Settings -->
Settings --> Companies` and clicking on **Update Info**.
.. _accounting-setup-bank:
Bank Account
------------
Connect your bank account to your database and have your bank statements synced automatically. To do
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.
If your Bank Institution cant 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
filling out the form.
- **Name**: the bank account's name, as displayed on Odoo.
- **Account Number**: your bank account number (IBAN in Europe).
- **Bank**: click on *Create and Edit* to configure the bank's details. Add the bank institution's
name and its Identifier Code (BIC or SWIFT).
- **Code**: this code is your Journal's *Short Code*, as displayed on Odoo. By default, Odoo creates
a new Journal with this Short Code.
- **Journal**: This field is displayed if you have an existing Bank Journal that is not linked yet
to a bank account. If so, then select the *Journal* you want to use to record the financial
transactions linked to this bank account or create a new one by clicking on *Create and Edit*.
.. note::
- You can add as many bank accounts as needed with this tool by going to :menuselection:`Accounting
--> Configuration`, and clicking on *Add a Bank Account*.
- :doc:`Click here <../../bank/setup/bank_accounts>` for more information about Bank
Accounts.
.. _accounting-setup-periods:
Accounting Periods
------------------
Define here your **Fiscal Years** opening and closing dates, which are used to generate reports
automatically, and your **Tax Return Periodicity**, along with a reminder to never miss a tax return
deadline.
By default, the opening date is set on the 1st of January and the closing date on the 31st of
December, as this is the most common use.
.. note::
You can also change these settings by going to :menuselection:`Accounting --> Configuration -->
Settings --> Fiscal Periods` and updating the values.
.. _accounting-setup-chart:
Chart of Accounts
-----------------
With this menu, you can add accounts to your **Chart of Accounts** and indicate their initial
opening balances.
Basic settings are displayed on this page to help you review your Chart of Accounts. To access all
the settings of an account, click on the *double arrow button* at the end of the line.
.. image:: media/setup_chart_of_accounts.png
:align: center
:alt: Setup of the Chart of Accounts and their opening balances in Odoo Accounting
.. note::
:doc:`Click here <chart_of_accounts>` for more information on how to configure your Chart of
Accounts.
Invoicing onboarding banner
===========================
There is another step-by-step onboarding banner that helps you take advantage of your Odoo Invoicing
and Accounting apps. The *Invoicing onboarding banner* is the one that welcomes you if you use the
Invoicing app rather than the Accounting app.
If you have Odoo Accounting installed on your database, you can reach it by going to
:menuselection:`Accounting --> Customers --> Invoices`.
The Invoicing onboarding banner is composed of four main steps:
.. image:: media/setup_invoicing_onboarding.png
:align: center
:alt: Step-by-step onboarding banner in Odoo Invoicing
#. :ref:`invoicing-setup-company`
#. :ref:`invoicing-setup-layout`
#. :ref:`invoicing-setup-payment`
#. :ref:`invoicing-setup-sample`
.. _invoicing-setup-company:
Company Data
------------
This form is the same as :ref:`the one presented in the Accounting onboarding banner
<accounting-setup-company>`.
.. _invoicing-setup-layout:
Invoice Layout
--------------
With this tool, you can design the appearance of your documents by selecting which layout tamplate,
paper format, colors, font, and logo you want to use.
You can also add your *Company Tagline* and the content of the documents *footer*. Note that Odoo
automatically adds the company's phone number, email, website URL, and Tax ID (or VAT number) to the
footer, according to the values you previously configured in the :ref:`Company Data
<accounting-setup-company>`.
.. image:: media/setup_document_layout.png
:align: center
:alt: Document layout configuration in Odoo Invoicing
.. tip::
Add your **bank account number** and a link to your **General Terms & Condition** in the footer.
This way, your contacts can find the full content of your GT&C online without having to print
them on the invoices you issue.
.. note::
These settings can also be modified by going to :menuselection:`Settings --> General Settings`,
under the *Business Documents* section.
.. _invoicing-setup-payment:
Payment Method
--------------
This menu helps you configure the payment methods with which your customers can pay you.
.. important::
Configuring a *Payment Acquirer* with this tool also activates the *Invoice Online Payment*
option automatically. With this, users can directly pay online, from their Customer Portal.
.. _invoicing-setup-sample:
Sample Invoice
--------------
Send yourself a sample invoice by email to make sure everything is correctly configured.
.. seealso::
* :doc:`../../bank/setup/bank_accounts`
* :doc:`chart_of_accounts`
* :doc:`../../bank/feeds/bank_synchronization`
* :doc:`../../fiscal_localizations/overview/fiscal_localization_packages`
* `Odoo Learn: Accounting Basics <https://www.odoo.com/r/lsZ>`_