Colombia

Webinars

Below you can find videos with a general description of the localization, and how to configure it.

Introduction

Electronic invoicing for Colombia is available from Odoo 12 and requires the next modules:

  1. l10n_co: All the basic data to manage the accounting module, contains the default setup for: chart of accounts, taxes, retentions, identification document types

  2. 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

../../../../../_images/colombia01.png

Configuration

Install the Colombian localization modules

To install the modules, go to Apps, remove the Apps filter and search for “Colombia”. Then click on Install for the first two modules.

../../../../../_images/colombia02.png

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.

Go to Accounting ‣ Configuration ‣ Settings and look for the Colombian Electronic Invoice section.

../../../../../_images/colombia03.png

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/

CSC is the default for new databases.

Once that Odoo and Carvajal are fully configured and ready for production the testing environment can be disabled.

Configure your report data

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 Accounting ‣ Configuration ‣ Settings and look for the Colombian Electronic Invoice section.

../../../../../_images/colombia04.png

Configure data required in the XML

Partner

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:

../../../../../_images/colombia05.png

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.

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 .

These fields can be found in Partner ‣ Sales & Purchase Tab ‣ Fiscal Information

../../../../../_images/colombia06.png

Additionally two booleans 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.

../../../../../_images/colombia07.png

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.

../../../../../_images/colombia08.png

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 developer mode: Accounting ‣ Settings ‣ Configuration Setting ‣ Journals.

../../../../../_images/colombia09.png

Once that the sequence is opened, the Prefix and Next Number fields should be configured and synchronized with the CEN Financiero.

../../../../../_images/colombia10.png

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:

../../../../../_images/colombia11.png

Usage and testing

Invoice

When all your master data and credentials has been configured, it’s possible to start testing the electronic invoice workflow.

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:

../../../../../_images/colombia12.png

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.

Invoice validation

After the invoice is validated an XML file is created and sent automatically to Carvajal, this file is displayed in the chatter.

../../../../../_images/colombia13.png

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”:

../../../../../_images/colombia14.png

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.

../../../../../_images/colombia17.png

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:

../../../../../_images/colombia18.png ../../../../../_images/colombia19.png

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.