[IMP] accounting/l10n_co: additional context

closes odoo/documentation#6685

X-original-commit: 6045a60dd5
Signed-off-by: Zachary Straub (zst) <zst@odoo.com>
Signed-off-by: Samuel Lieber (sali) <sali@odoo.com>
Co-authored-by: dade-odoo <87431108+dade-odoo@users.noreply.github.com>
Co-authored-by: larm-odoo <121518652+larm-odoo@users.noreply.github.com>

content/applications/finance/fiscal_localizations/colombia.rst

@@ -4,15 +4,16 @@ Colombia
 
 .. |DIAN| replace:: :abbr:`DIAN (Dirección de Impuestos y Aduanas Nacionales)`
 
-Odoo's Colombian localization package provides accounting, fiscal and legal features in Colombia
+Odoo's Colombian localization package provides accounting, fiscal, and legal features for databases
-such as chart of accounts, taxes and electronic invoicing.
+in Colombia – such as chart of accounts, taxes, and electronic invoicing.
 
-In addition, we have a series of videos covering how to start from scratch, configuration, main
+In addition, a series of videos on the subject is also available. These videos cover how to start
-workflows, and specific use cases.
+from scratch, set up configurations, complete common workflows, and provide in-depth looks at some
+specific use cases as well.
 
 .. seealso::
-   `Odoo Colombian localization videos
+   `Smart Tutorial - Colombian Localization
-   <https://www.youtube.com/playlist?list=PL1-aSABtP6ABxZshems3snMjx7bj_7ZsZ>`_.
+   <https://www.odoo.com/slides/smart-tutorial-localizacion-de-colombia-132>`_.
 
 .. _colombia/configuration:
 
@@ -36,74 +37,78 @@ localization:
      - `l10n_co`
      - Default :ref:`fiscal localization package <fiscal_localizations/packages>`. This module adds
        the base accounting features for the Colombian localization: chart of accounts, taxes,
-       withholdings, identification document type.
+       withholdings, and identification document type.
    * - :guilabel:`Colombian - Accounting Reports`
      - `l10n_co_reports`
      - Includes accounting reports for sending certifications to suppliers for withholdings applied.
    * - :guilabel:`Electronic invoicing for Colombia with Carvajal`
      - `l10n_co_edi`
-     - This module includes the features that are required for the integration with Carvajal and
+     - This module includes the features required for integration with Carvajal, and
-       generates the electronic invoices and support document related to the vendor bills based on
+       generates the electronic invoices and support documents related to the vendor bills, based on
        |DIAN| regulations.
    * - :guilabel:`Colombian - Point of Sale`
      - `l10n_co_pos`
-     - Includes Point of Sale Receipt for Colombian Localization.
+     - Includes Point of Sale receipts for Colombian localization.
 
 .. note::
-   When a database is created from scratch selecting :guilabel:`Colombia` as the country, Odoo
+   When `Colombia` is selected for a company's :guilabel:`Fiscal Localization`, Odoo automatically
-   automatically installs the base modules *Colombia - Accounting* and *Colombia - Accounting
+   installs certain modules.
-   Reports*.
 
 Company configuration
 ---------------------
 
-To configure your company information, go to the :menuselection:`Contacts` app and search for your
+To configure your company information, go to the :menuselection:`Contacts` app, and search for your
-company. Alternatively, activate :ref:`developer mode <developer-mode>` and navigate to
+company.
+
+Alternatively, activate :ref:`developer mode <developer-mode>` and navigate to
 :menuselection:`General Setting --> Company --> Update Info --> Contact`. Then, edit the contact
-form to configure the following information:
+form and configure the following information:
 
 - :guilabel:`Company Name`.
-- :guilabel:`Address`: Including :guilabel:`City`, :guilabel:`Department` and :guilabel:`Zip Code`.
+- :guilabel:`Address`: Including :guilabel:`City`, :guilabel:`Department` and :guilabel:`ZIP` code.
-- :guilabel:`Tax ID`: When it is a `NIT`, it must have the *verification digit* at the end of the ID
+- :guilabel:`Identification Number`: Select the :guilabel:`Identification Type` (`NIT`, `Cédula de
-  followed by a hyphen (`-`).
+  Ciudadanía`, `Registro Civil`, etc.). When the :guilabel:`Identification Type` is `NIT`, the
+  :guilabel:`Identification Number` **must** have the *verification digit* at the end of the ID
+  prefixed by a hyphen (`-`).
 
 Next, configure the :guilabel:`Fiscal Information` in the :guilabel:`Sales & Purchase` tab:
 
 - :guilabel:`Obligaciones y Responsabilidades`: Select the fiscal responsibility for the company
-  (:guilabel:`O-13` Gran Contribuyente, :guilabel:`O-15` Autorretenedor, :guilabel:`O-23` Agente de
+  (`O-13` Gran Contribuyente, `O-15` Autorretenedor, `O-23` Agente de retención IVA, `O-47` Regimen
-  retención IVA, :guilabel:`O-47` Regimen de tributación simple, :guilabel:`R-99-PN` No Aplica).
+  de tributación simple, `R-99-PN` No Aplica).
 - :guilabel:`Gran Contribuyente`: If the company is *Gran Contribuyente* this option should be
   selected.
-- :guilabel:`Fiscal Regimen`: Select the Tribute Name for the company (:guilabel:`IVA`,
+- :guilabel:`Fiscal Regimen`: Select the Tribute Name for the company (`IVA`, `INC`, `IVA e INC`,
-  :guilabel:`INC`, :guilabel:`IVA e INC`, :guilabel:`No Aplica`)
+  or `No Aplica`)
 - :guilabel:`Commercial Name`: If the company uses a specific commercial name, and it needs to be
   displayed in the invoice.
 
 Carjaval credentials configuration
 ----------------------------------
 
-Once the modules installed, the user credentials must be configured in order to connect with
+Once the modules are installed, the user credentials **must** be configured, in order to connect
-Carvajal Web Service. Navigate to :menuselection:`Accounting --> Configuration --> Settings` and
+with Carvajal Web Service. To do so, navigate to :menuselection:`Accounting --> Configuration -->
-scroll to the :guilabel:`Colombian Electronic Invoicing` section. Then, fill in the required
+Settings` and scroll to the :guilabel:`Colombian Electronic Invoicing` section. Then, fill in the
-configuration information provided by Carvajal:
+required configuration information provided by Carvajal:
 
-- :guilabel:`Username` and :guilabel:`Password`: Correspond to the username and password provided
+- :guilabel:`Username` and :guilabel:`Password`: Username and password (provided by Carvajal) to the
-  by Carvajal to the company.
+  company.
 - :guilabel:`Company Registry`: Company's NIT number *without* the verification code.
-- :guilabel:`Account ID`: Company ID followed by `_01`.
+- :guilabel:`Account ID`: Company's NIT number followed by `_01`.
-- :guilabel:`Colombia Template Code`: Select one of the two available templates (:guilabel:`CGEN03`
+- :guilabel:`Colombia Template Code`: Select one of the two available templates (`CGEN03` or
-  or :guilabel:`CGNE04`) to be used in the PDF format of the electronic invoice.
+  `CGNE04`) to be used in the PDF format of the electronic invoice.
 
-.. image:: colombia/carvajal-configuration.png
+Enable the :guilabel:`Test mode` checkbox to connect with the Carvajal testing environment.
-   :alt: Configure credentials for Carvajal web service in Odoo.
 
-.. note::
+Once Odoo and Carvajal are fully configured and ready for production, deactivate the :guilabel:`Test
-   Check the :guilabel:`Test mode` checkbox to connect with the Carvajal testing environment. Once
-   Odoo and Carvajal are fully configured and ready for production, uncheck the :guilabel:`Test
 mode` checkbox to use the production database.
 
+.. image:: colombia/carvajal-configuration.png
+   :align: center
+   :alt: Configure credentials for Carvajal web service in Odoo.
+
 .. important::
-   :guilabel:`Test mode` must be used **only** on replicated databases, **not** the production
+   :guilabel:`Test mode` must **only** be used on duplicated databases, **not** the production
    environment.
 
 Report data configuration
@@ -112,8 +117,17 @@ Report data configuration
 Report data can be defined for the fiscal section and bank information of the PDF as part of the
 configurable information sent in the XML.
 
-Navigate to :menuselection:`Accounting --> Configuration --> Settings` and scroll to the
+Navigate to :menuselection:`Accounting --> Configuration --> Settings`, and scroll to the
-:guilabel:`Colombian Electronic Invoicing` section.
+:guilabel:`Colombian Electronic Invoicing` section, in order to find the :guilabel:`Report
+Configuration` fields. Here the header information for each report type can be configured.
+
+- :guilabel:`Gran Contribuyente`
+- :guilabel:`Tipo de Régimen`
+- :guilabel:`Retenedores de IVA`
+- :guilabel:`Autorretenedores`
+- :guilabel:`Resolución Aplicable`
+- :guilabel:`Actividad Económica`
+- :guilabel:`Bank Information`
 
 .. _colombia/master-data:
 
@@ -123,67 +137,85 @@ Master data configuration
 Partner
 ~~~~~~~
 
+Partner contacts can be created in the *Contacts* app. To do so, navigate to
+:menuselection:`Contacts`, and click the :guilabel:`Create` button.
+
+Then, name the contact, and using the radio buttons, select the contact type, either
+:guilabel:`Individual` or :guilabel:`Company`.
+
+Complete the full :guilabel:`Address`, including the :guilabel:`City`, :guilabel:`State`, and
+:guilabel:`ZIP` code. Then, complete the identification and fiscal information.
+
 Identification information
 **************************
 
-Document types defined by the |DIAN| are available on the partner form as part of the Colombian
+Identification types, defined by the |DIAN|, are available on the partner form, as part of the
-localization. Colombian partners must have their :guilabel:`Identification Number` (VAT) and
+Colombian localization. Colombian partners **must** have their :guilabel:`Identification Number`
-:guilabel:`Document Type` set.
+(VAT) and :guilabel:`Document Type` set.
 
 .. tip::
    When the :guilabel:`Document Type` is `NIT`, the :guilabel:`Identification Number` needs to be
-   configured in Odoo, including the *verification digit*; Odoo splits this number when the data to
+   configured in Odoo, including the *verification digit at the end of the ID, prefixed by a hyphen
-   is sent to the third party.
+   (`-`)*.
 
 Fiscal information
 ******************
 
-The partner's responsibility codes (section 53 in the RUT document) are included as part of the
+The partner's responsibility codes (section 53 in the :abbr:`RUT (Registro único tributario)`
-electronic invoicing module, as it is required by the |DIAN|.
+document) are included as part of the electronic invoicing module, as it is required by the |DIAN|.
 
 The required fields can be found under :menuselection:`Partner --> Sales & Purchase Tab --> Fiscal
-Information`:
+Information section`:
 
 - :guilabel:`Obligaciones y Responsabilidades`: Select the fiscal responsibility for the company
-  (:guilabel:`O-13` Gran Contribuyente, :guilabel:`O-15` Autorretenedor, :guilabel:`O-23` Agente de
+  (`O-13` Gran Contribuyente, `O-15` Autorretenedor, `O-23` Agente de retención IVA, `O-47` Regimen
-  retención IVA, :guilabel:`O-47` Regimen de tributación simple, :guilabel:`R-99-PN` No Aplica).
+  de tributación simple, or `R-99-PN` No Aplica).
 - :guilabel:`Gran Contribuyente`: If the company is *Gran Contribuyente* this option should be
   selected.
-- :guilabel:`Fiscal Regimen`: Select the Tribute Name for the company (:guilabel:`IVA`,
+- :guilabel:`Fiscal Regimen`: Select the tribute name for the company (`IVA`, `INC`, `IVA e INC`, or
-  :guilabel:`INC`, :guilabel:`IVA e INC`, :guilabel:`No Aplica`)
+  `No Aplica`)
 - :guilabel:`Commercial Name`: If the company uses a specific commercial name, and it needs to be
   displayed in the invoice.
 
 Products
 ~~~~~~~~
 
-In addition to adding general information (in the :guilabel:`General Information` tab) on the
+To manage products, navigate to :menuselection:`Accounting --> Customers --> Products`, then click
-product form, either the :guilabel:`UNSPSC Category`, :guilabel:`Barcode`, or :guilabel:`Internal
+on a product.
-Reference` field must also be configured.
+
+When adding general information on the product form, it is required that either the
+:guilabel:`UNSPSC Category` (:guilabel:`Accounting` tab), or :guilabel:`Internal Reference`
+(:guilabel:`General Information` tab) field is configured. Be sure to :guilabel:`Save` the product
+once configured.
 
 Taxes
 ~~~~~
 
-If sales transactions include products with taxes, the :guilabel:`Value Type` field in the
+To create or modify taxes, go to :menuselection:`Accounting --> Configuration --> Taxes`, and select
-:guilabel:`Advanced Options` tab needs to be configured per tax. To do so, go to
+the related tax.
-:menuselection:`Accounting --> Configuration --> Taxes`, and select the related tax.
 
-Retention tax types (:guilabel:`ICA`, :guilabel:`IVA`, :guilabel:`Fuente`) are also included. This
+If sales transactions include products with taxes, the :guilabel:`Value Type` field in the
-configuration is used to display taxes in the invoice PDF correctly.
+:guilabel:`Advanced Options` tab needs to be configured per tax. Retention tax types
+(:guilabel:`ICA`, :guilabel:`IVA`, :guilabel:`Fuente`) are also included. This configuration is used
+to display taxes correctly in the invoice PDF.
 
 .. image:: colombia/retention-tax-types.png
+   :align: center
    :alt: The ICA, IVA and Fuente fields in the Advanced Options tab in Odoo.
 
+.. _co-journals:
+
 Sales journals
 ~~~~~~~~~~~~~~
 
-.. _co-journals:
-
 Once the |DIAN| has assigned the official sequence and prefix for the electronic invoice resolution,
-the sales journals related to the invoice documents must be updated in Odoo. To do so, navigate to
+the sales journals related to the invoice documents **must** be updated in Odoo. To do so, navigate
-:menuselection:`Accounting --> Configuration --> Journals`.
+to :menuselection:`Accounting --> Configuration --> Journals`, and select an existing sales journal,
+or create a new one with the :guilabel:`Create` button.
 
-Configure the following data in the :guilabel:`Advanced Settings` tab:
+On the sales journal form, input the :guilabel:`Journal Name`, :guilabel:`Type`, and set a unique
+:guilabel:`Short Code` in the :guilabel:`Journals Entries` tab. Then, configure the following data
+in the :guilabel:`Advanced Settings` tab:
 
 - :guilabel:`Electronic invoicing`: Enable :guilabel:`UBL 2.1 (Colombia)`.
 - :guilabel:`Invoicing Resolution`: Resolution number issued by |DIAN| to the company.
@@ -193,32 +225,31 @@ Configure the following data in the :guilabel:`Advanced Settings` tab:
 - :guilabel:`Range of Numbering (maximum)`: Last authorized invoice number.
 
 .. note::
-   The sequence and resolution of the journal must match the one configured in Carvajal and the
+   The sequence and resolution of the journal **must** match the one configured in Carvajal and the
    |DIAN|.
 
 Invoice sequence
 ****************
 
-The invoice sequence and prefix must be correctly configured when the first document is created.
+The invoice sequence and prefix **must** be correctly configured when the first document is created.
 
 .. note::
-   Odoo automatically assigns a prefix and sequence to the following documents.
+   Odoo automatically assigns a prefix and sequence to the following invoices.
 
 Purchase journals
 *****************
 
-Once the |DIAN| has assigned the official sequence and prefix for the support document related to
+Once the |DIAN| has assigned the official sequence and prefix for the *support document* related to
 vendor bills, the purchase journals related to their supporting documents need to be updated in
 Odoo. The process is similar to the configuration of the :ref:`sales journals <co-journals>`.
 
 Chart of accounts
 *****************
 
-The :doc:`chart of accounts
+The :doc:`chart of accounts </applications/finance/accounting/get_started/chart_of_accounts>` is
-</applications/finance/accounting/get_started/chart_of_accounts>` is installed by default as part of
+installed by default as part of the localization module, the accounts are mapped automatically in
-the localization module, the accounts are mapped automatically in taxes, default account payable,
+taxes, default account payable, and default account receivable. The chart of accounts for Colombia
-and default account receivable. The chart of accounts for Colombia is based on the PUC (Plan Unico
+is based on the PUC (Plan Unico de Cuentas).
-de Cuentas).
 
 .. _colombia/workflows:
 
@@ -228,18 +259,38 @@ Main workflows
 Electronic invoices
 -------------------
 
+The following is a breakdown of the main workflow for electronic invoices with the Colombian
+localization:
+
+#. Sender creates an invoice.
+#. Electronic invoice provider generates the legal XML file.
+#. Electronic invoice provider creates the CUFE (Invoice Electronic Code) with the electronic
+   signature.
+#. Electronic invoice provider sends a notification to |DIAN|.
+#. |DIAN| validates the invoice.
+#. |DIAN| accepts or rejects the invoice.
+#. Electronic invoice provider generates the PDF invoice with a QR code.
+#. Electronic invoice provider sends invoice to the acquirer.
+#. Acquirer sends a receipt of acknowledgement, and accepts or rejects the invoice.
+#. Sender downloads a :file:`.zip` file with the PDF and XML.
+
+.. image:: colombia/workflow-electronic-invoice.png
+   :align: center
+   :alt: Electronic invoice workflow for Colombian localization.
+
 .. _colombia/invoice-creation:
 
 Invoice creation
 ~~~~~~~~~~~~~~~~
 
 .. note::
-   The functional workflow taking place before an invoice validation does not alter the main changes
+   The functional workflow taking place before an invoice validation does **not** alter the main
-   introduced with the electronic invoice.
+   changes introduced with the electronic invoice.
 
 Electronic invoices are generated and sent to both the |DIAN| and customer through Carvajal's web
-service integration. These documents can be created from your sales order or manually. Go to
+service integration. These documents can be created from your sales order or manually generated. To
-:menuselection:`Accounting --> Customers --> Invoices` and configure:
+create a new invoice, go to :menuselection:`Accounting --> Customers --> Invoices`, and select
+:guilabel:`Create`. On the invoice form configure the following fields:
 
 - :guilabel:`Customer`: Customer's information.
 - :guilabel:`Journal`: Journal used for electronic invoices.
@@ -259,9 +310,10 @@ invoice is then processed asynchronously by the E-invoicing service UBL 2.1 (Col
 also displayed in the chatter.
 
 .. image:: colombia/invoice-sent.png
+   :align: center
    :alt: Carvajal XML invoice file in Odoo chatter.
 
-The :guilabel:`Electronic Invoice Name` field is now displayed in the :guilabel:`EDI Documents` tab
+The :guilabel:`Electronic Invoice Name` field is now displayed in the :guilabel:`EDI Documents` tab,
 with the name of the XML file. Additionally, the :guilabel:`Electronic Invoice Status` field is
 displayed with the initial value :guilabel:`To Send`. To process the invoice manually, click on the
 :guilabel:`Process Now` button.
@@ -271,7 +323,7 @@ displayed with the initial value :guilabel:`To Send`. To process the invoice man
 Reception of legal XML and PDF
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-The electronic invoice vendor (Carvajal) receives the XML file and proceeds to validate its
+The electronic invoice vendor (Carvajal) receives the XML file, and proceeds to validate its
 structure and information.
 
 After validating the electronic invoice, proceed to generate a legal XML which includes a digital
@@ -279,10 +331,11 @@ signature and a unique code (CUFE), a PDF invoice that includes a QR code and th
 generated. If everything is correct the :guilabel:`Electronic Invoicing` field value changes to
 :guilabel:`Sent`.
 
-A ZIP containing the legal electronic invoice in XML format and the invoice in PDF format is
+A :file:`.zip` containing the legal electronic invoice (in XML format) and the invoice in (PDF
-downloaded and displayed in the invoice chatter:
+format) is downloaded and displayed in the invoice chatter:
 
 .. image:: colombia/invoice-zip.png
+   :align: center
    :alt: ZIP file displayed in the invoice chatter in Odoo.
 
 The electronic invoice status changes to :guilabel:`Accepted`.
@@ -292,7 +345,7 @@ Credit notes
 
 The process for credit notes is the same as for invoices. To create a credit note with reference to
 an invoice, go to :menuselection:`Accounting --> Customers --> Invoices`. On the invoice, click
-:guilabel:`Add Credit Note` and complete the following information:
+:guilabel:`Add Credit Note`, and complete the following information:
 
 - :guilabel:`Credit Method`: Select the type of credit method.
 
@@ -316,7 +369,7 @@ Debit notes
 
 The process for debit notes is similar to credit notes. To create a debit note with reference to an
 invoice, go to :menuselection:`Accounting --> Customers --> Invoices`. On the invoice, click the
-:guilabel:`Add Debit Note` button and complete the following information:
+:guilabel:`Add Debit Note` button, and enter the following information:
 
 - :guilabel:`Reason`: Type the reason for the debit note.
 - :guilabel:`Debit note date`: Select the specific options.
@@ -331,7 +384,7 @@ Support document for vendor bills
 ---------------------------------
 
 With master data, credentials, and the purchase journal configured for support documents related to
-vendor bills, you can start using support documents.
+vendor bills, you can start using *support documents*.
 
 Support documents for vendor bills can be created from your purchase order or manually. Go to
 :menuselection:`Accounting --> Vendors --> Bills` and fill in the following data:
@@ -372,6 +425,7 @@ Commerce (ICA) tax. The report can be found under :menuselection:`Accounting -->
 Colombian Statements --> Certificado de Retención en ICA`.
 
 .. image:: colombia/ica-report.png
+   :align: center
    :alt: Certificado de Retención en ICA report in Odoo Accounting.
 
 Certificado de Retención en IVA
@@ -382,6 +436,7 @@ can be found under :menuselection:`Accounting --> Reporting --> Colombian Statem
 de Retención en IVA`.
 
 .. image:: colombia/iva-report.png
+   :align: center
    :alt: Certificado de Retención en IVA report in Odoo Accounting.
 
 Certificado de Retención en la Fuente
@@ -392,4 +447,5 @@ be found under :menuselection:`Accounting --> Reporting --> Colombian Statements
 Retención en Fuente`.
 
 .. image:: colombia/fuente-report.png
+   :align: center
    :alt: Certificado de Retención en Fuente report in Odoo Accounting.