NextERP/documentation
5
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

[REF] l10n: PoC doc restructure for CO

Browse Source 
closes odoo/documentation#5477

X-original-commit: e52d8f172f
Signed-off-by: Jonathan Castillo (jcs) <jcs@odoo.com>
This commit is contained in:
Sam Lieber (sali)
2022-09-01 18:50:41 +00:00
parent de12ddddf9
commit 50b766837a
73 changed files with 182 additions and 777 deletions
Download Patch File Download Diff File Expand all files Collapse all files
content/applications/finance/fiscal_localizations/colombia.rst
+179 -171
View File
@@ -2,85 +2,86 @@
Colombia
========
Webinars
========
The following documentation covers the Colombian localization modules and their basic concepts to
understand, implement, and use Colombian localization in Odoo.
Below you can find videos with a general description of the localization, and how to configure it.
- Configure Master Data for Colombia
- Use and configure Electronic Invoicing in Odoo for Colombia.
- :ref:`Invoice creation <colombia/invoice-creation>` and :ref:`validation
<colombia/invoice-validation>`
- :ref:`Reception of legal XML and PDF <colombia/invoice-xml>`
- :ref:`Avoid common mistakes <colombia/common-errors>`
- :ref:`Financial reports <colombia/reports>`
- `VIDEO WEBINAR OF A COMPLETE DEMO <https://youtu.be/Y83p3YK1lFU>`_.
.. seealso::
`Smart Tutorial - Localización de Colombia
<https://www.odoo.com/slides/smart-tutorial-localizacion-de-colombia-132>`_
Introduction
============
Electronic invoicing for Colombia is available from Odoo 12 and
requires the next modules:
#. **l10n_co**: All the basic data to manage the accounting module,
contains the default setup for: chart of accounts, taxes,
retentions, identification document types
#. **l10n_co_edi**: This module includes all the extra fields that are
required for the Integration with Carvajal and generate the
electronic invoice, based on the DIAN legal requirements.
Workflow
========
.. image:: colombia/colombia01.png
:align: center
.. _colombia/configuration:
Configuration
=============
Install the Colombian localization modules
------------------------------------------
Modules installation
--------------------
To :ref:`install <general/install>` the modules, go to :menuselection:`Apps`, remove the *Apps*
filter and search for "Colombia". Then click on *Install* for the first two modules.
:ref:`Install <general/install>` the following modules to get all the features of the Colombian
localization:
.. image:: colombia/colombia02.png
:align: center
.. list-table::
:header-rows: 1
:widths: 25 25 50
* - Name
- Technical name
- Description
* - :guilabel:`Colombia - Accounting`
- `l10n_co`
- Default :ref:`fiscal localization package <fiscal_localizations/packages>`
* - :guilabel:`Electronic invoicing for Colombia with Carvajal`
- `l10n_co_edi`
- Carvajal e-invoicing integration
* - :guilabel:`Colombian - Point of Sale`
- `l10n_co_pos`
- Point of Sale
* - :guilabel:`Colombian - Accounting Reports`
- `l10n_co_reports`
- Colombian reports
Configure credentials for Carvajal web service
----------------------------------------------
Once that the modules are installed, in order to be able to connect
with Carvajal Web Service, it's necessary to configure the user
and credentials, this information will be provided by Carvajal.
Once the modules are installed, the user credentials need to be configured in order to connect with
Carvajal Web Service. First, navigate to :menuselection:`Accounting --> Configuration --> Settings`
and look for the :guilabel:`Colombian Electronic Invoice` section. Then, fill in the required
configuration information provided by Carvajal.
Go to :menuselection:`Accounting --> Configuration --> Settings` and
look for the *Colombian Electronic Invoice* section.
.. image:: colombia/carvajal-credential-config.png
:alt: Configure credentials for Carvajal web service in Odoo.
.. image:: colombia/colombia03.png
:align: center
Check the :guilabel:`Test mode` checkbox to connect with the Carvajal testing environment. This
allows users to test the complete workflow and integration with the :abbr:`CEN (Centro Electrónico
de Negocios)` Financiero portal, which is accessible here:
Using the Testing mode it is possible to connect with a Carvajal
testing environment. This allows users to test the complete workflow
and integration with the CEN Financiero portal, which is accessible
here:
- `CTS (Carvajal T&S) <https://cenflab.cen.biz/site/>`_.
- `CSC (Carvajal Servicios de Comunicación) <https://web-stage.facturacarvajal.com/>`_.
CTS (Carvajal T&S)
https://cenflab.cen.biz/site/
:abbr:`CSC (Carvajal Servicios de Comunicación)` is the default for new databases.
CSC (Carvajal Servicios de Comunicación)
https://web-stage.facturacarvajal.com/
Once Odoo and Carvajal are fully configured and ready for production, the testing environment can be
disabled by unchecking the :guilabel:`Test mode` checkbox.
CSC is the default for new databases.
Configure report data
---------------------
Once that Odoo and Carvajal are fully configured and ready for
production the testing environment can be disabled.
Report data can be defined for the fiscal section and the bank information in the PDF as part of the
configurable information that is sent in the XML.
Configure your report data
--------------------------
Navigate to :menuselection:`Accounting --> Configuration --> Settings` and look for the
:guilabel:`Colombian Electronic Invoice` section.
As part of the configurable information that is sent in the XML, you
can define the data for the fiscal section and the bank information in
the PDF.
Go to :menuselection:`Accounting --> Configuration --> Settings` and
look for the *Colombian Electronic Invoice* section.
.. image:: colombia/colombia04.png
:align: center
.. image:: colombia/report-config.png
:alt: Configure the report data in Odoo.
Configure data required in the XML
----------------------------------
@@ -88,174 +89,181 @@ Configure data required in the XML
Partner
~~~~~~~
Configure the identification number and fiscal structure.
Identification
**************
As part of the Colombian Localization, the document types defined by
the DIAN are now available on the Partner form. Colombian partners
have to have their identification number and document type set:
As part of the Colombian Localization, the document types defined by the :abbr:`DIAN (Dirección de
Impuestos y Aduanas Nacionales)` are now available on the Partner form. Colombian partners have to
have their identification number (:guilabel:`VAT`) and :guilabel:`Document Type` set:
.. image:: colombia/colombia05.png
:align: center
.. image:: colombia/partner-rut-doc-type.png
:alt: The document type of RUT set in Odoo.
.. tip:: When the document type is RUT the identification number needs
to be configured in Odoo including the verification digit, Odoo
will split this number when the data to the third party vendor is
sent.
.. tip::
When the :guilabel:`Document Type` is `RUT`, the identification number needs to be configured in
Odoo, including the verification digit, Odoo will split this number when the data to the
third-party vendor is sent.
Fiscal structure (RUT)
**********************
The partner's responsibility codes (section 53 in the RUT document)
are included as part of the electronic invoice module given that is
part of the information required by the DIAN .
The partner's responsibility codes (section 53 in the RUT document) are included as part of the
electronic invoice module, given it is part of the information required by the :abbr:`DIAN
(Dirección de Impuestos y Aduanas Nacionales)`.
These fields can be found in :menuselection:`Partner --> Sales &
Purchase Tab --> Fiscal Information`
The required fields can be found in :menuselection:`Partner --> Sales & Purchase Tab --> Fiscal
Information`.
.. image:: colombia/colombia06.png
:align: center
.. image:: colombia/partner-fiscal-information.png
:alt: The fiscal information included in the electronic invoice module in Odoo.
Additionally two booleans fields were added in order to specify the
fiscal regimen of the partner.
Additionally, two boolean fields were added in order to specify the fiscal regimen of the partner.
Taxes
~~~~~
If your sales transactions include products with taxes, it's important
to consider that an extra field *Value Type* needs to be configured
per tax. This option is located in the Advanced Options tab.
If sales transactions include products with taxes, the :guilabel:`Value Type` field in the
:guilabel:`Advanced Options tab` needs to be configured per tax.
.. image:: colombia/colombia07.png
:align: center
Retention tax types (ICA, IVA, Fuente) are also included in the options to configure taxes. This
configuration is used in order to display taxes in the invoice PDF correctly.
Retention tax types (ICA, IVA, Fuente) are also included in the
options to configure your taxes. This configuration is used in order
to correctly display taxes in the invoice PDF.
.. image:: colombia/colombia08.png
:align: center
Journals
~~~~~~~~
Once the DIAN has assigned the official sequence and prefix for the
electronic invoice resolution, the Sales journals related to your
invoice documents need to be updated in Odoo. The sequence can be
accessed using the :ref:`developer mode <developer-mode>`: :menuselection:`Accounting -->
Settings --> Configuration Setting --> Journals`.
.. image:: colombia/colombia09.png
:align: center
Once that the sequence is opened, the Prefix and Next Number fields
should be configured and synchronized with the CEN Financiero.
.. image:: colombia/colombia10.png
:align: center
.. image:: colombia/retention-tax-types.png
:alt: The ICA, IVA and Fuente fields in the Advanced Options tab in Odoo.
Users
~~~~~
The default template that is used by Odoo on the invoice PDF includes
the job position of the salesperson, so these fields should be
configured:
The default template that is used by Odoo on the invoice PDF includes the job position of the
salesperson, so the :guilabel:`Job Position` field should be configured.
.. image:: colombia/colombia11.png
:align: center
.. _colombia/workflows:
Usage and testing
=================
Main workflows
==============
Invoice
-------
.. image:: colombia/electronic-invoice-workflow.png
:alt: Electronic invoice workflow in Odoo.
When all your master data and credentials has been configured, it's
possible to start testing the electronic invoice workflow.
.. _colombia/invoice-creation:
Invoice creation
~~~~~~~~~~~~~~~~
----------------
The functional workflow that takes place before an invoice validation
doesn't change. The main changes that are introduced with the
electronic invoice are the next fields:
.. image:: colombia/colombia12.png
:align: center
The functional workflow that takes place before an invoice validation doesn't change. The main
changes that are introduced with the electronic invoice are the next fields.
There are three types of documents:
- **Factura Electronica**: This is the regular type of document and
its applicable for Invoices, Credit Notes and Debit Notes.
- **Factura de Importación**: This should be selected for importation
transactions.
- **Factura de contingencia**: This is an exceptional type that is
used as a manual backup in case that the company is not able to use
the ERP and it's necessary to generate the invoice manually, when
this invoice is added to the ERP, this invoice type should be
selected.
- **Factura Electronica**: This is the regular document type applicable for Invoices, Credit Notes
and Debit Notes.
- **Factura de Importación**: This should be selected for importation transactions.
- **Factura de contingencia**: This is an exceptional type that is used as a manual backup if the
company is not able to use the ERP and if it is necessary to generate the invoice manually when
this invoice is added to the ERP.
.. _colombia/invoice-validation:
Invoice validation
~~~~~~~~~~~~~~~~~~
------------------
After the invoice is validated an XML file is created and sent
automatically to Carvajal, this file is displayed in the chatter.
After the invoice is validated, an XML file is created and sent automatically to Carvajal. This file
is also displayed in the chatter.
.. image:: colombia/colombia13.png
:align: center
.. image:: colombia/carvajal-invoice-xml-chatter.png
:alt: Carvajal XML invoice file in Odoo chatter.
An extra field is now displayed in "Other Info" tab with the name of
the XML file. Additionally there is a second extra field that is
displayed with the Electronic Invoice status, with the initial value
"In progress":
The :guilabel:`Electronic Invoice Name` field is now displayed in the :guilabel:`Other Info` tab
with the name of the XML file. Additionally, the :guilabel:`Electronic Invoice Status` field is
displayed with the initial value :guilabel:`In progress`.
.. image:: colombia/colombia14.png
:align: center
.. _colombia/invoice-xml:
Reception of legal XML and PDF
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
------------------------------
The electronic invoice vendor receives the XML file and proceeds to
validate the structure and the information in it, if everything is
correct the invoice status changes to "Validated" after using the
"Check Carvajal Status" button in the Action dropdown. They then
proceed to generate a Legal XML which includes a digital signature and
a unique code (CUFE), a PDF invoice that includes a QR code and the
CUFE is also generated.
The electronic invoice vendor receives the XML file and proceeds to validate the structure and the
information in it. In the :guilabel:`Action` drop-down menu, select the :guilabel:`Check Carvajal
Status` button. If everything is correct, the :guilabel:`Electronic Invoice Status` field value
changes to :guilabel:`Validated`. Then, proceed to generate a legal XML, which includes a digital
signature and a unique code (CUFE), a PDF invoice that includes a QR code, and the CUFE is also
generated.
After this:
- A ZIP containing the legal XML and the PDF is downloaded and
displayed in the invoice chatter:
- A ZIP containing the legal XML and the PDF is downloaded and displayed in the invoice chatter:
.. image:: colombia/colombia15.png
.. image:: colombia/zip-invoice-chatter.png
:alt: ZIP file displayed in the invoice chatter in Odoo.
.. image:: colombia/colombia16.png
.. image:: colombia/zip-file-contents.png
:alt: XML and PDF contained in invoice ZIP file.
- The Electronic Invoice status changes to "Accepted"
- The electronic invoice status changes to :guilabel:`Accepted`.
.. _colombia/common-errors:
Common errors
~~~~~~~~~~~~~
-------------
During the XML validation the most common errors are usually related
to missing master data. In such cases, error messages are shown in the
chatter after updating the electronic invoice status.
During the XML validation, the most common errors are usually related to missing master data. In
such cases, error messages are shown in the chatter after updating the electronic invoice status.
.. image:: colombia/colombia17.png
:align: center
.. image:: colombia/xml-validation-errors.png
:alt: XML validation errors shown in the invoice chatter in Odoo.
After the master data is corrected, it's possible to reprocess the XML
with the new data and send the updated version, using the following
button:
After the master data is corrected, it's possible to reprocess the XML with the new data and send
the updated version, using the following button in the :guilabel:`Action` drop-down menu.
.. image:: colombia/colombia18.png
:align: center
.. image:: colombia/colombia19.png
:align: center
.. image:: colombia/updated-invoice-status.png
:alt: The updated invoice status in Odoo.
Additional use cases
--------------------
The process for credit and debit notes is exactly the same as the
invoice, the functional workflow remains the same as well.
The process for credit and debit notes is exactly the same as the invoice. The functional workflow
remains the same as well.
.. _colombia/reports:
Financial reports
=================
This information is a quick reference to the accounting reports included in the *Colombian
Localization Accounting Reports* module.
Certificado de Retención en ICA
-------------------------------
This report is a certification to vendors for withholdings made for the Colombian Industry and
Commerce tax (ICA).
Go to :menuselection:`Accounting --> Reporting --> Colombian Statements --> Certificado de Retención
en ICA`.
.. image:: colombia/ica-report.png
:alt: Certificado de Retención en ICA report in Odoo Accounting.
Certificado de Retención en IVA
-------------------------------
This report issues a certificate on the amount withheld from vendors for VAT withholding.
Go to :menuselection:`Accounting --> Reporting --> Colombian Statements --> Certificado de Retención
en IVA`.
.. image:: colombia/iva-report.png
:alt: Certificado de Retención en IVA report in Odoo Accounting.
Certificado de Retención en la Fuente
-------------------------------------
This certificate is issued to partners for the withholding tax that they have made.
Go to :menuselection:`Accounting --> Reporting --> Colombian Statements --> Certificado de Retención
en Fuente`.
.. image:: colombia/fuente-report.png
:alt: Certificado de Retención en Fuente report in Odoo Accounting.