odoo-forge-bundle 0.1.0

package/payload/skills/odoo18-docs/references/docs/applications/finance/accounting/reporting/tax_carryover.md

@@ -0,0 +1,42 @@
+---
+title: "Tax carryover"
+source_url: "https://docs.odoo.sbggai.top/applications/finance/accounting/reporting/tax_carryover.html"
+---
+
+=============
+# Tax carryover
+
+When performing tax reports, the **tax carryover** feature allows carrying amounts from one period
+to another without creating new entries.
+
+It has been created to meet the legal requirements of specific locations, where amounts must be
+transferred from period to period (for example, because the total of the line is negative).
+
+The feature is activated by default in countries where it is required, such as Belgium, France, and
+Italy. There is no specific configuration required.
+
+Let’s take an example of a Belgian company that created a credit note of 100 for one of their
+customers. The due tax is 21%.
+
+.. image:: tax_carryover/belgian-example.png
+   :align: center
+   :alt: Illustration with a credit note
+
+In this case, as per local regulation, grid 81 of the tax report may contain a negative amount. But
+it must be declared to the government as zero, and the negative amount should be carried over to the
+next period.
+
+If we go to :menuselection:`Accounting app --> Reporting --> Tax Report`, a pop-up on line 81
+explains that the amount will be carried over in the next period.
+
+.. image:: tax_carryover/pop-up.png
+   :align: center
+   :alt: pop-up message stating the amount will be carried over to the next period
+
+At the time of the tax closing period, the tax report shows that the amount was carried over from
+the previous period. It also indicates the amount that will be carried over to this line in the next
+period based on the existing transactions and the carryover from the previous period.
+
+.. image:: tax_carryover/tax-return.png
+   :align: center
+   :alt: Illustration of the tax return

package/payload/skills/odoo18-docs/references/docs/applications/finance/accounting/reporting/tax_returns.md

@@ -0,0 +1,114 @@
+---
+title: "Tax return (VAT declaration)"
+source_url: "https://docs.odoo.sbggai.top/applications/finance/accounting/reporting/tax_returns.html"
+---
+
+============================
+# Tax return (VAT declaration)
+
+Companies with a registered :abbr:`VAT (Value Added Tax)` number must submit a **tax return** on
+a monthly or quarterly basis, depending on their turnover and the registration regulation. A tax
+return - or VAT return - gives the tax authorities information about the taxable transactions made
+by the company. The **output tax** is charged on the number of goods and services sold by a
+business, while the **input tax** is the tax added to the price when goods or services are
+purchased. Based on these values, the company can calculate the tax amount they have to pay or be
+refunded.
+
+> **note**:
+>    You can find additional information about VAT and its mechanism on this page from the European
+   Commission: ["What is VAT?" ](https://ec.europa.eu/taxation_customs/business/vat/what-is-vat_en).
+
+.. _tax-returns/prerequisites:
+
+# Prerequisites
+
+.. _tax-returns/periodicity:
+
+## Tax Return Periodicity
+
+The configuration of the **Tax Return Periodicity** allows Odoo to compute your tax return correctly
+and also to send you a reminder to never miss a tax return deadline.
+
+To do so, go to :menuselection:`Accounting --> Configuration --> Settings`. Under the
+:guilabel:`Tax Return Periodicity`, you can set:
+
+- :guilabel:`Periodicity`: define here whether you submit your tax return on a monthly or quarterly
+  basis;
+- :guilabel:`Reminder`: define when Odoo should remind you to submit your tax return;
+- :guilabel:`Journal`: select the journal in which to record the tax return.
+
+
+> **note**:
+>    This is usually configured during the :doc:`app's initial set up <../get_started>`.
+
+.. _tax-returns/tax-grids:
+
+## Tax Grids
+
+Odoo generates tax reports based on the :guilabel:`Tax Grids` settings that are configured on your
+taxes. Therefore, it is crucial to make sure that all recorded transactions use the right taxes.
+You can see the :guilabel:`Tax Grids` by opening the :guilabel:`Journal Items` tab of any
+invoice and bill.
+
+.. image:: tax_returns/tax_return_grids.png
+   :alt: see which tax grids are used to record transactions in Odoo Accounting
+
+To configure your tax grids, go to :menuselection:`Accounting --> Configuration --> Taxes`,
+and open the tax you want to modify. There, you can edit your tax settings, along with the tax
+grids that are used to record invoices or refunds.
+
+> **note**:
+>    Taxes and reports are usually already pre-configured in Odoo: a :ref:`fiscal localization package
+   <fiscal_localizations/packages>` is installed according to the country you select at the creation
+   of your database.
+
+.. _tax-returns/close:
+
+# Close a tax period
+
+.. _tax-returns/lock-date:
+
+## Tax lock date
+
+Any new transaction whose accounting date prior to the :guilabel:`Lock Tax Return` date has its tax
+values moved to the next open tax period. This is useful to make sure that no change can be made to
+a report once its period is closed.
+
+Therefore, we recommend locking your tax date before working on your
+:guilabel:`Closing Journal Entry`.
+This way, other users cannot modify or add transactions that would have an impact on the
+:guilabel:`Closing Journal Entry`, which can help you avoid some tax declaration errors.
+
+To check the current :guilabel:`Lock Tax Return` date, or to edit it, go to
+:menuselection:`Accounting --> Accounting --> Lock Dates`.
+
+.. _tax-returns/report:
+
+## Tax return
+
+Once all the transactions involving taxes have been posted for the period you want to report, open
+the :guilabel:`Tax Return` report by going to :menuselection:`Accounting --> Reporting --> Tax
+Return`. Select the period you want to declare using the date filter to have an overview of the tax
+return. Then, click :guilabel:`Closing Entry` to create a tax closing journal entry. Odoo
+automatically proposes the details of the journal entry. Make any necessary changes and click
+:guilabel:`Post`.
+
+From the report, click :guilabel:`PDF` to download a PDF of the tax return. Alternatively, click the
+:icon:`fa-cog` (:guilabel:`gear`) icon, then click :guilabel:`Download Excel` to download an XLSX of
+the tax return. To save the report to the Documents app, click the :icon:`fa-cog` (:guilabel:`gear`)
+icon, then click :guilabel:`Copy to Documents`. Select the format to :guilabel:`Export to`, the
+:guilabel:`Documents Name`, the :guilabel:`Folder` to store it in, and add any :guilabel:`Tags`.
+
+The report includes all the values to report to the tax authorities, along with the amount to be
+paid or refunded.
+
+> **note**:
+>    If you forgot to lock your tax date before clicking on :guilabel:`Closing Journal Entry`, then
+   Odoo automatically locks your fiscal period on the same date as the accounting date of your
+   entry. This safety mechanism can prevent some fiscal errors, but it is advised to lock your tax
+   date manually before, as described above.
+
+.. seealso::
+   * :doc:`../taxes`
+   * :doc:`../get_started`
+   * :doc:`../../fiscal_localizations`

package/payload/skills/odoo18-docs/references/docs/applications/finance/accounting/reporting/year_end.md

@@ -0,0 +1,114 @@
+---
+title: "Year-end closing"
+source_url: "https://docs.odoo.sbggai.top/applications/finance/accounting/reporting/year_end.html"
+---
+
+================
+# Year-end closing
+
+Year-end closing is vital for maintaining financial accuracy, complying with regulations, making
+informed decisions, and ensuring transparency in reporting.
+
+.. _year-end/fiscal-years:
+
+# Fiscal years
+
+By default, the fiscal year is set to last 12 months and end on December 31st. However, its duration
+and end date can vary due to cultural, administrative, and economic considerations.
+
+To modify these values, go to :menuselection:`Accounting --> Configuration --> Settings`. Under the
+:guilabel:`Fiscal Periods` section, change the :guilabel:`Last Day` field if necessary.
+
+If the period lasts *more* than or *less* than 12 months, enable :guilabel:`Fiscal Years` and
+:guilabel:`Save`. Go back to the :guilabel:`Fiscal Periods` section and click :guilabel:`➜ Fiscal
+Years`. From there, click :guilabel:`Create`, give it a :guilabel:`Name`, and both a
+:guilabel:`Start Date` and :guilabel:`End Date`.
+
+> **note**:
+>    Once the set fiscal period is over, Odoo automatically reverts to the default periodicity, taking
+   into account the value specified in the :guilabel:`Last Day` field.
+
+.. _year-end/checklist:
+
+# Year-end checklist
+
+## Before closure
+
+Before closing a fiscal year, ensure first everything is accurate and up-to-date:
+
+- Make sure all bank accounts are fully :doc:`reconciled <../bank/reconciliation>` up to year-end,
+  and confirm that the ending book balances match the bank statement balances.
+- Verify that all :doc:`customer invoices <../customer_invoices>` have been entered and
+  approved and that there are no draft invoices.
+- Confirm that all :doc:`vendor bills  <../vendor_bills>` have been entered and agreed upon.
+- Validate all :doc:`expenses <../../expenses>`, ensuring their accuracy.
+- Corroborate that all :doc:`received payments <../payments>` have been encoded and recorded
+  accurately.
+- Close all :ref:`suspense accounts <accounting/bank/suspense>`.
+- Book all :doc:`depreciation <../vendor_bills/assets>` and :doc:`deferred revenue
+  <../customer_invoices/deferred_revenues>` entries.
+
+## Closing a fiscal year
+
+Then, to close the fiscal year:
+
+- Run a :ref:`tax report <accounting/reporting/tax-report>`, and verify that all tax information is
+  correct.
+- Reconcile all accounts on the :ref:`balance sheet <accounting/reporting/balance-sheet>`:
+
+  - Update the bank balances in Odoo according to the actual balances found on the bank statements.
+  - Reconcile all transactions in the cash and bank accounts by running the :ref:`aged receivables
+    <accounting/reporting/aged-receivable>` and :ref:`aged payables
+    <accounting/reporting/aged-payable>` reports.
+  - Audit all accounts, being sure to fully understand all transactions and their nature, making
+    sure to include loans and fixed assets.
+  - Optionally, :ref:`match payments <accounting/payments/auto-reconcile-tool>` to validate any open
+    vendor bills and customer invoices with their payments. While this step is optional, it could
+    assist the year-end closing process if all outstanding payments and invoices are reconciled,
+    potentially finding errors or mistakes in the system.
+
+Next, the accountant likely verifies balance sheet items and book entries for:
+
+  - year-end manual adjustments,
+  - work in progress,
+  - depreciation journal entries,
+  - loans,
+  - tax adjustments,
+  - etc.
+
+If the accountant is going through the year-end audit, they may want to have paper copies of all
+balance sheet items (such as loans, bank accounts, prepayments, sales tax statements, etc.) to
+compare these with the balances in Odoo.
+
+> **tip**:
+>    During this process, it is good practice to set a :guilabel:`Journal Entries Lock Date` to the
+   last day (inclusive) of the preceding fiscal year by going to :menuselection:`Accounting -->
+   Accounting --> Lock Dates`. This way, the accountant can be confident that nobody changes the
+   transactions while auditing the books. Users from the *accountant* access group can still create
+   and modify entries.
+
+### Current year's earnings
+
+Odoo uses a unique account type called **current year's earnings** to display the amount difference
+between the **income** and **expenses** accounts.
+
+> **note**:
+>    The chart of accounts can only contain one account of this type. By default, it is a 999999
+   account named :guilabel:`Undistributed Profits/Losses`.
+
+To allocate the current year's earnings, create a miscellaneous entry to book them to any equity
+account. Once done, confirm whether or not the current year's earnings in the **balance sheet** is
+correctly reporting a balance of zero. If that is the case, set an :guilabel:`All Users Lock Date`
+to the last day of the fiscal year by going to :menuselection:`Accounting --> Accounting --> Lock
+Dates`.
+
+> **tip**:
+>    Install the :guilabel:`Irreversible Lock Date` (`account_lock`) module to make the :guilabel:`All
+   Users Lock Date` *irreversible* once set.
+
+> **note**:
+>    A specific year-end closing entry is **optional** in order to close out the **profit and loss
+   statement**. The reports are created in real-time, meaning that the profit and loss statement
+   corresponds directly with the year-end date specified in Odoo. Therefore, any time the **income
+   statement** is generated, the beginning date corresponds with the beginning of the **fiscal
+   year** and all account balances should equal zero.

package/payload/skills/odoo18-docs/references/docs/applications/finance/accounting/reporting.md

@@ -0,0 +1,138 @@
+---
+title: ""
+source_url: "https://docs.odoo.sbggai.top/applications/finance/accounting/reporting.html"
+---
+
+:show-content:
+# 
+# Reporting
+
+Odoo includes **generic** and **dynamic** reports available for all countries, regardless of the
+:doc:`localization package <../../finance/fiscal_localizations>` installed:
+
+-  :ref:`accounting/reporting/balance-sheet`
+-  :ref:`accounting/reporting/profit-and-loss`
+-  :ref:`accounting/reporting/executive-summary`
+-  :ref:`accounting/reporting/general-ledger`
+-  :ref:`accounting/reporting/aged-receivable`
+-  :ref:`accounting/reporting/aged-payable`
+-  :ref:`accounting/reporting/cash-flow-statement`
+-  :ref:`accounting/reporting/tax-report`
+
+To expand the lines of a report and view its details, click the :icon:`fa-caret-right`
+(:guilabel:`right arrow`) on the left. Then click the :icon:`fa-caret-down` (:guilabel:`down arrow`)
+to the right of the account, journal entry, payment, invoice, etc. to :guilabel:`Annotate` and view
+the details.
+
+.. image:: reporting/reporting-annotate.png
+   :alt: Annotate reports.
+
+To export reports in PDF or XLSX format, click :guilabel:`PDF` at the top or click the
+:icon:`fa-caret-down` (:guilabel:`down arrow`) icon next to the :guilabel:`PDF` button and
+select :guilabel:`XLSX`.
+
+To compare values across periods, click the :guilabel:`Comparison` menu and select the periods you
+want to compare.
+
+.. image:: reporting/reporting-comparison.png
+   :alt: Comparison menu to compare time periods.
+
+.. _accounting/reporting/balance-sheet:
+
+# Balance Sheet
+
+The :guilabel:`Balance Sheet` shows a snapshot of your organization's assets, liabilities, and
+equity at a particular date.
+
+.. _accounting/reporting/profit-and-loss:
+
+# Profit and Loss
+
+The :guilabel:`Profit and Loss` report (or **Income Statement**) shows your company's net income by
+deducting expenses from revenue for the reporting period.
+
+.. _accounting/reporting/executive-summary:
+
+# Executive Summary
+
+The :guilabel:`Executive Summary` provides an overview of all the important figures for overseeing
+your company's performance.
+
+It includes the following items:
+
+- :guilabel:`Performance`:
+    - :guilabel:`Gross profit margin`:
+        The contribution of all sales your business makes **minus** any direct costs needed to
+        make those sales (labor, materials, etc.).
+    - :guilabel:`Net profit margin`:
+        The contribution of all sales made by your business **minus** any direct costs needed to
+        make those sales *and* fixed overheads your company has (electricity, rent, taxes
+        to be paid as a result of those sales, etc.).
+    - :guilabel:`Return on investment (per annum)`:
+        The ratio of the net profit to the amount of assets the company used to make those profits.
+- :guilabel:`Position`:
+    - :guilabel:`Average debtors days`:
+        The average number of days it takes your customers to (fully) pay you across all your
+        customer invoices.
+    - :guilabel:`Average creditors days`:
+        The average number of days it takes you to (fully) pay your suppliers across all your bills.
+    - :guilabel:`Short-term cash forecast`:
+        How much cash is expected in or out of your business in the next month, i.e., the balance of
+        your **Sales account** for the month **minus** the balance of your **Purchases account** for
+        the month.
+    - :guilabel:`Current assets to liabilities`:
+        Also referred to as the **current ratio**, this is the ratio of current assets (:dfn:`assets
+        that could be turned into cash within a year`) to the current liabilities (:dfn:`liabilities
+        that will be due in the next year`). It is typically used to measure a company's ability to
+        service its debt.
+
+.. _accounting/reporting/general-ledger:
+
+# General Ledger
+
+The :guilabel:`General Ledger` report shows all transactions from all accounts for a selected date
+range. The initial summary report shows the totals for each account. To expand an account and view
+its details, click the :icon:`fa-caret-right` (:guilabel:`right arrow`) on the left.
+This report is useful for reviewing each transaction that occurred during a specific period.
+
+.. _accounting/reporting/aged-receivable:
+
+# Aged Receivable
+
+The :guilabel:`Aged Receivable` report shows the sales invoices awaiting payment during a selected
+month and several months prior.
+
+.. _accounting/reporting/aged-payable:
+
+# Aged Payable
+
+The :guilabel:`Aged Payable` report displays information on individual bills, credit notes, and
+overpayments you owe and how long these have gone unpaid.
+
+.. _accounting/reporting/cash-flow-statement:
+
+# Cash Flow Statement
+
+The :guilabel:`Cash Flow Statement` shows how changes in balance sheet accounts and income affect
+cash and cash equivalents and breaks the analysis down to operating, investing, and financing
+activities.
+
+.. _accounting/reporting/tax-report:
+
+# Tax Report
+
+The :guilabel:`Tax Report` shows the :guilabel:`NET` and :guilabel:`TAX` amounts for all the
+taxes grouped by type (:guilabel:`Sales`/:guilabel:`Purchases`).
+
+.. toctree::
+   :titlesonly:
+
+   reporting/tax_returns
+   reporting/tax_carryover
+   reporting/analytic_accounting
+   reporting/budget
+   reporting/intrastat
+   reporting/data_inalterability
+   reporting/silverfin
+   reporting/customize
+   reporting/year_end

package/payload/skills/odoo18-docs/references/docs/applications/finance/accounting/taxes/B2B_B2C.md

@@ -0,0 +1,182 @@
+---
+title: "B2B (tax excluded) and B2C (tax included) pricing"
+source_url: "https://docs.odoo.sbggai.top/applications/finance/accounting/taxes/B2B_B2C.html"
+---
+
+=================================================
+# B2B (tax excluded) and B2C (tax included) pricing
+
+When working with consumers, prices are usually expressed with taxes
+included in the price (e.g., in most eCommerce). But, when you work in a
+B2B environment, companies usually negotiate prices with taxes excluded.
+
+Odoo manages both use cases easily, as long as you register your prices
+on the product with taxes excluded or included, but not both together.
+If you manage all your prices with tax included (or excluded) only, you
+can still easily do sales order with a price having taxes excluded (or
+included): that's easy.
+
+This documentation is only for the specific use case where you need to
+have two references for the price (tax included or excluded), for the
+same product. The reason of the complexity is that there is not a
+symmetrical relationship with prices included and prices excluded, as
+shown in this use case, in belgium with a tax of 21%:
+
+-  Your eCommerce has a product at **10€ (taxes included)**
+
+-  This would do **8.26€ (taxes excluded)** and a **tax of 1.74€**
+
+But for the same use case, if you register the price without taxes on
+the product form (8.26€), you get a price with tax included at 9.99€,
+because:
+
+-  **8.26€ \* 1.21 = 9.99€**
+
+So, depending on how you register your prices on the product form, you
+will have different results for the price including taxes and the price
+excluding taxes:
+
+-  Taxes Excluded: **8.26€ & 10.00€**
+
+-  Taxes Included: **8.26€ & 9.99€**
+
+> **note**:
+>   If you buy 100 pieces at 10€ taxes included, it gets even more
+  tricky. You will get: **1000€ (taxes included) = 826.45€ (price) +
+  173.55€ (taxes)** Which is very different from a price per piece at
+  8.26€ tax excluded.
+
+This documentation explains how to handle the very specific use case
+where you need to handle the two prices (tax excluded and included) on
+the product form within the same company.
+
+> **note**:
+>   In terms of finance, you have no more revenues selling your
+  product at 10€ instead of 9.99€ (for a 21% tax), because your revenue
+  will be exactly the same at 9.99€, only the tax is 0.01€ higher. So, if
+  you run an eCommerce in Belgium, make your customer a favor and set your
+  price at 9.99€ instead of 10€. Please note that this does not apply to
+  20€ or 30€, or other tax rates, or a quantity >1. You will also make you
+  a favor since you can manage everything tax excluded, which is less
+  error prone and easier for your salespeople.
+
+# Configuration
+
+## Introduction
+
+The best way to avoid this complexity is to choose only one way of
+managing your prices and stick to it: price without taxes or price with
+taxes included. Define which one is the default stored on the product
+form (on the default tax related to the product), and let Odoo compute
+the other one automatically, based on the pricelist and fiscal position.
+Negotiate your contracts with customers accordingly. This perfectly
+works out-of-the-box and you have no specific configuration to do.
+
+If you can not do that and if you really negotiate some prices with tax
+excluded and, for other customers, others prices with tax included, you
+must:
+
+#.  always store the default price **tax excluded** on the product form, and
+    apply a tax (price excluded on the product form)
+
+#.  create a pricelist with prices in **tax included**, for specific
+    customers
+
+#.  create a fiscal position that switches the tax excluded to a tax
+    included
+
+#.  assign both the pricelist and the fiscal position to customers who
+    want to benefit to this pricelist and fiscal position
+
+For the purpose of this documentation, we will use the above use case:
+
+-   your product default sale price is 8.26€ tax excluded
+
+-   but we want to sell it at 10€, tax included, in our shops or
+    eCommerce website
+
+.. _b2b_b2c/ecommerce:
+
+## eCommerce
+
+If you only use B2C or B2B prices on your website, simply select the appropriate setting in the
+**Website** app settings.
+
+If you have both B2B and B2C prices on a single website, please follow these instructions:
+
+#. Activate the :ref:`developer mode <developer-mode>` and go to :menuselection:`General Settings
+   --> Users & Companies --> Groups`.
+#. Open either `Technical / Tax display B2B` or `Technical / Tax display B2C`.
+#. Under the :guilabel:`Users` tab, add the users requiring access to the price type. Add B2C users
+   in the B2C group and B2B users in the B2B group.
+
+## Setting your products
+
+Your company must be configured with tax excluded by default. This is
+usually the default configuration, but you can check your **Default Sale
+Tax** from the menu :menuselection:`Configuration --> Settings`
+of the Accounting application.
+
+.. image:: B2B_B2C/price_B2C_B2B01.png
+  :align: center
+
+Once done, you can create a **B2C** pricelist. You can activate the
+pricelist feature per customer from the menu:
+:menuselection:`Configuration --> Settings` of the Sale application.
+Choose the option **different prices per customer segment**.
+
+Once done, create a B2C pricelist from the menu
+:menuselection:`Configuration --> Pricelists`.
+It's also good to rename the default pricelist into B2B to avoid confusion.
+
+Then, create a product at 8.26€, with a tax of 21% (defined as tax not
+included in price) and set a price on this product for B2C customers at
+10€, from the :menuselection:`Sales --> Products`
+menu of the Sales application:
+
+.. image:: B2B_B2C/price_B2C_B2B02.png
+  :align: center
+
+## Setting the B2C fiscal position
+
+From the accounting application, create a B2C fiscal position from this
+menu: :menuselection:`Configuration --> Fiscal Positions`.
+This fiscal position should map the VAT 21% (tax excluded of price)
+with a VAT 21% (tax included in price)
+
+.. image:: B2B_B2C/price_B2C_B2B03.png
+  :align: center
+
+# Test by creating a quotation
+
+Create a quotation from the Sale application, using the
+:menuselection:`Sales --> Quotations` menu. You should have the
+following result: 8.26€ + 1.73€ = 9.99€.
+
+.. image:: B2B_B2C/price_B2C_B2B04.png
+  :align: center
+
+Then, create a quotation but **change the pricelist to B2C and the
+fiscal position to B2C** on the quotation, before adding your product.
+You should have the expected result, which is a total price of 10€ for
+the customer: 8.26€ + 1.74€ = 10.00€.
+
+.. image:: B2B_B2C/price_B2C_B2B05.png
+  :align: center
+
+This is the expected behavior for a customer of your shop.
+
+# Avoid changing every sale order
+
+If you negotiate a contract with a customer, whether you negotiate tax
+included or tax excluded, you can set the pricelist and the fiscal
+position on the customer form so that it will be applied automatically
+at every sale of this customer.
+
+The pricelist is in the **Sales & Purchases** tab of the customer form,
+and the fiscal position is in the accounting tab.
+
+Note that this is error prone: if you set a fiscal position with tax
+included in prices but use a pricelist that is not included, you might
+have wrong prices calculated for you. That's why we usually recommend
+companies to only work with one price reference.