diff --git a/content/applications/finance/fiscal_localizations/ecuador.rst b/content/applications/finance/fiscal_localizations/ecuador.rst index 2142f6990d..9d6575d586 100644 --- a/content/applications/finance/fiscal_localizations/ecuador.rst +++ b/content/applications/finance/fiscal_localizations/ecuador.rst @@ -2,7 +2,7 @@ Ecuador ======= -With the Ecuadorian localization, it is possible to generate electronic documents using XML, fiscal +With the Ecuadorian localization, electronic documents can be generated using XML, fiscal folio, electronic signature, and direct connection to tax authority SRI. The supported documents are invoices, credit notes, debit notes, purchase liquidations, and @@ -18,32 +18,23 @@ each purchase invoice. - :doc:`Documentation on e-invoicing's legality and compliance in Ecuador <../accounting/customer_invoices/electronic_invoicing/ecuador>` -.. _l10n_ec/glossary: - -Glossary -======== - -Here are some terms that are essential to the Ecuadorian localization: - -- **SRI**: Stands for *Servicio de Rentas Internas*, which is the government organization that - enforces the payment of taxes in Ecuador. -- **SRI certificate**: Document or digital credential issued by the *SRI* that is crucial for - compliance with Ecuadorian tax laws. -- **EDI**: Stands for *Electronic Data Interchange*, which refers to the electronic transmission of - documents. -- **RIMPE**: Stands for *Regimen Simplificado para Emprendedores y Negocios*, which is the type of - taxpayer qualified for SRI. - -Configuration -============= - -.. _l10n_ec/module-installation: - -Modules installation --------------------- +.. tip:: + - **SRI**: *Servicio de Rentas Internas*, the government organization that enforces the payment + of taxes in Ecuador. + - **SRI certificate**: Document or digital credential issued by the *SRI* that is crucial for + compliance with Ecuadorian tax laws. + - **EDI**: *Electronic Data Interchange*, which refers to the electronic transmission of + documents. + - **RIMPE**: *Regimen Simplificado para Emprendedores y Negocios*, the type of taxpayer qualified + for SRI. + +.. _localizations/ecuador/module-installation: + +Modules +======= -:ref:`Install ` the following modules to get all the features of the Ecuadorian -localization: +:doc:`Install ` the following modules to get all the features of +the Ecuadorian localization: .. list-table:: :header-rows: 1 @@ -54,18 +45,18 @@ localization: - Description * - :guilabel:`Ecuadorian - Accounting` - `l10n_ec` - - The default :doc:`fiscal localization package <../fiscal_localizations>`, adds accounting + - The default :doc:`fiscal localization package <../fiscal_localizations>` adds accounting characteristics for the Ecuadorian localization, which represent the minimum configuration required for a company to operate in Ecuador according to the guidelines set by the :abbr:`SRI (servicio de rentas internas)`. The module's installation automatically loads: - Chart of Accounts, taxes, documents types, tax support types. Additionally, the generation of - forms 103 and 104 are automatic. + a chart of accounts, taxes, document types, and tax support types. Additionally, the + generation of forms 103 and 104 is automatic. * - :guilabel:`Ecuadorian Accounting EDI` - `l10n_ec_edi` - Includes all the technical and functional requirements to generate and validate - :doc:`Electronics Documents <../accounting/customer_invoices/electronic_invoicing>`, based on + :doc:`Electronics Documents <../accounting/customer_invoices/electronic_invoicing>` based on the technical documentation published by the SRI. The authorized documents are: Invoices, - Credit Notes, Debit Notes, Withholdings and Purchase liquidations. + Credit Notes, Debit Notes, Withholdings, and Purchase liquidations. * - :guilabel:`Ecuadorian Accounting Reports` - `l10n_ec_reports` - Includes all the technical and functional requirements to generate forms 103 and 104. @@ -81,15 +72,104 @@ localization: - `l10n_ec_edi_pos` - Includes all the technical and functional requirements to generate automatic electronic invoices from a POS sale. + * - :guilabel:`Ecuadorian Delivery Guide` + - `l10n_ec_edi_stock` + - Includes all the technical and functional requirements to generate :ref:`electronic delivery + guides `. .. note:: - In some cases, such as when upgrading to a version with additional modules, it is possible that - those modules may not be installed automatically. Any missing modules can be manually installed. + In some cases, such as when upgrading to a version with additional modules, those modules may not + be installed automatically. Any missing modules can be manually + :doc:`installed `. + +.. seealso:: + :doc:`/applications/hr/payroll/payroll_localizations` are documented separately. + +.. _localizations/ecuador/specifics: + +Localization overview +===================== + +The Ecuadorian localization package ensures compliance with Ecuadorian fiscal and accounting +regulations. It includes tools for managing taxes, fiscal positions, reporting, and a predefined +chart of accounts tailored to Ecuador's standards. + +The Ecuadorian localization package provides the following key features to ensure compliance with +local fiscal and accounting regulations: + +- :doc:`../accounting/get_started/chart_of_accounts`: a predefined structure aligned with the latest + standards of Ecuador’s *Superintendency of Companies*, organized into multiple categories and + fully compatible with NIIF accounting +- :ref:`Products ` +- :ref:`Taxes `: pre-configured tax rates, including standard VAT, + zero-rated, and exempt options +- :doc:`../accounting/taxes/fiscal_positions`: automated tax adjustments based on customer or + supplier registration status +- :ref:`Document types `: classification of transactions like + *customer invoices* and *vendor bills* using government-defined document types set by the SRI + (Ecuador’s tax authority) +- :ref:`Company and contacts ` +- :ref:`Electronic documents ` +- :ref:`VAT withholding ` +- :ref:`Printer points ` +- :ref:`Withholding ` +- :ref:`Reporting ` + +.. _localizations/ecuador/products: + +Products +-------- + +If products have any :doc:`withholding taxes <../accounting/taxes/retention>`, they must be +configured on the product form. To do so, go to :menuselection:`Accounting --> Vendors --> +Products`. On the :guilabel:`General Information` tab, specify both :guilabel:`Purchase Taxes` and +:guilabel:`Profit Withhold`. -.. _l10n_ec/configure-your-company: +.. _localizations/ecuador/taxes: -Configure a company or individual contact ------------------------------------------ +Taxes +----- + +To manage taxes, navigate to :menuselection:`Accounting --> Configuration --> Taxes`. Depending on +the tax type, the following options may be required for additional configuration: + +- :guilabel:`Tax Name`: Follows a specific format depending on the tax type: + + - | **For IVA (Value-Added Tax)**: + | `IVA [percent] (104, [form code] [tax support code] [tax support short name])` + | Example: `IVA 12% (104, RUC [tax support code] IVA)` + - | **For Income Tax Withholding codes**: + | `Code ATS [percent of withhold] [withhold name]` + | Example: `Code ATS 10% Retención a la Fuente` + +- :guilabel:`Tax Support`: Configure only for the IVA tax. This option is used to register purchase + withholdings. +- :guilabel:`Code ATS`: Configure only for income tax withholding codes, as it is necessary to + register a withholding. + +In the :guilabel:`Definition` tab: + +- :guilabel:`Tax Grids`: Configure the code of a 104 form if it is an IVA tax, and the code of a + 103 form if it is an income tax withholding code. + +.. seealso:: + :doc:`Configuring taxes <../accounting/taxes>` + +.. _localizations/ecuador/document types: + +Document types +-------------- + +To access or configure document types, go to :menuselection:`Accounting --> Configuration --> +Document Types`. Each document type can have a unique sequence per journal where it is assigned. As +part of the localization, the document type includes the country where the document is applicable; +also, the data is created automatically when the localization module is installed. The information +required for the document types is included by default and doesn't need to be changed. + +.. _localizations/ecuador/company-contact: + +Company and contact +------------------- .. seealso:: :doc:`Configure a company or individual contact <../../essentials/contacts>` @@ -99,7 +179,7 @@ The following fields should be completed for localization purposes on the contac - :guilabel:`Name`: Enter the company or individual's name. - :guilabel:`Address`: The :guilabel:`Street` sub-field is required to confirm electronic invoices. - :guilabel:`Identification Number`: For a company, enter the :guilabel:`Ruc`. For individuals, - enter the :guilabel:`Cedula` or :guilabel:`Passport` number. + enter the :guilabel:`Cédula` or :guilabel:`Passport` number. - :guilabel:`SRI Taxpayer Type`: Select the contact's SRI taxpayer type. - :guilabel:`Phone`: Enter the company or individual's phone number. - :guilabel:`Email`: Enter the company or individual's email. This email is used to send electronic @@ -107,8 +187,10 @@ The following fields should be completed for localization purposes on the contac .. note:: The :guilabel:`SRI Taxpayer Type` indicated on the contact form determines which :ref:`VAT and - profit withholding ` taxes apply when using this contact on a vendor - bill. + profit withholding ` taxes apply when using this contact + on a vendor bill. + +.. _localizations/ecuador/electronic-documents: Electronic documents -------------------- @@ -136,9 +218,8 @@ Configure the following information, starting with the :guilabel:`Electronic Inv :guilabel:`SRI Connection` section: -- :guilabel:`Certificate file for SRI`: Select the company's :ref:`SRI certificate - `. Click :icon:`oi-arrow-right` :guilabel:`SRI Certificates` to upload one, if - necessary. +- :guilabel:`Certificate file for SRI`: Select the company's :guilabel:`SRI certificate`. Click + :icon:`oi-arrow-right` :guilabel:`SRI Certificates` to upload one, if necessary. - :guilabel:`Use production servers`: Enable this option if electronic documents are used in the production environment; leave it disabled if the testing environment is used instead. @@ -157,7 +238,7 @@ Configure the following information, starting with the :guilabel:`Electronic Inv - The entered :guilabel:`Credit Card` withholding value is always applied when a credit or debit card SRI payment method is used. -.. _l10n_ec/VAT-withholding: +.. _localizations/ecuador/vat-withholding: VAT withholding --------------- @@ -167,15 +248,15 @@ VAT withholding skip this step. To configure a VAT withholding, go to :menuselection:`Accounting --> Configuration --> Taxpayer Type -SRI`. - -Configure the :guilabel:`Name` of the taxpayer type, the :guilabel:`Goods VAT Withholding`, and the -:guilabel:`Services VAT Withholding`. +SRI`. Then, configure the :guilabel:`Name` of the taxpayer type, the :guilabel:`Goods VAT +Withholding`, and the :guilabel:`Services VAT Withholding`. .. tip:: If the :guilabel:`Taxpayer Type` is :guilabel:`Rimpe`, configure the :guilabel:`Profit Withhold` percentage. +.. _localizations/ecuador/printer-points: + Printer points -------------- @@ -183,10 +264,8 @@ Printer points invoices, credit notes, and debit notes. To configure printer points, navigate to :menuselection:`Accounting --> Configuration --> -Journals`. - -For each electronic document, click :guilabel:`New`, and enter the following information on the -journal form: +Journals`. For each electronic document, click :guilabel:`New`, and enter the following information +on the journal form: - :guilabel:`Journal Name`: Enter in this format: `[Emission Entity]-[Emission Point] [Document Type]`, e.g., `001-001 Sales Documents`. @@ -213,7 +292,7 @@ in the following fields: - :guilabel:`Short Code`: Enter a unique 5-digit code for the accounting entry sequence (e.g., VT001). -Customer invoices, credit notes, and debit notes need to use the same journal as the +Customer invoices, credit notes, and debit notes must use the same journal as the :guilabel:`Emission Point`, whereas the :guilabel:`Entity Point` should be unique per journal. Finally, in the :guilabel:`Advanced Settings` tab, check the :guilabel:`Electronic invoicing` @@ -222,6 +301,8 @@ checkbox to enable sending XML/EDI invoices. .. seealso:: :doc:`../accounting/customer_invoices/electronic_invoicing` +.. _localizations/ecuador/withholding: + Withholding ----------- @@ -249,187 +330,165 @@ in the following fields: Finally, in the :guilabel:`Advanced Settings` tab, check the :guilabel:`Electronic invoicing` checkbox to enable sending XML/EDI invoices. -Purchase liquidations ---------------------- +.. _localizations/ecuador/reporting: -A specific journal must be created for *purchase liquidations*. Go to :menuselection:`Accounting --> -Configuration --> Journals`. Click :guilabel:`New`, and enter the following information: +Reporting +--------- -- :guilabel:`Journal Name`: Enter this format: `[Emission Entity]-[Emission Point] [Document Type]`, - e.g., `001-001 Purchase Liquidations`. -- :guilabel:`Type`: Refers to the journal type. Select :guilabel:`Purchase`. +Ecuadorian companies submit fiscal reports to the SRI, with Odoo supporting two main ones: **reports +103** and **104**. -Once the :guilabel:`Type` is selected, complete the following fields: +To get these reports, go to :menuselection:`Accounting --> Reporting --> Tax Return`. Click the +:icon:`fa-book` :guilabel:`Report:` icon and select `103 (EC)` or `104 (EC)`. -- :guilabel:`Purchase Liquidations`: Tick this checkbox to enable purchase liquidations. -- :guilabel:`Use Documents?`: Enable this option if legal invoicing (invoices, debit/credit notes) - is used, as this is the standard configuration. If not, select the option to record accounting - entries unrelated to legal invoicing documents, such as receipts, tax payments, or journal - entries. -- :guilabel:`Emission Entity`: Enter the facility number. -- :guilabel:`Emission Point`: Enter the printer point. -- :guilabel:`Emission address`: Enter the address of the facility. -- :guilabel:`Short Code`: Enter a unique 5-digit code for the accounting entry sequence (e.g., - `PT001`). +.. _localizations/ecuador/report-103: -Finally, in the :guilabel:`Advanced Settings` tab, check the :guilabel:`Electronic invoicing` -checkbox to enable sending XML/EDI invoices. +Report 103 +~~~~~~~~~~ -Configure master data ---------------------- +This report details income tax withholdings in a given period and can be reported monthly or +semi-annually. It includes information about base, tax amounts, and tax codes and can be used for +SRI reporting. -Chart of accounts -~~~~~~~~~~~~~~~~~ +.. _localizations/ecuador/report-104: -The :doc:`chart of accounts <../accounting/get_started/chart_of_accounts>` is installed by default -as part of the set of data included in the localization module. The accounts are mapped -automatically in *Taxes*, *Default Account Payable*, *Default Account Receivable*. +Report 104 +~~~~~~~~~~ -Ecuador's chart of accounts is based on the most updated version of the *Superintendency of -Companies*, which is grouped into several categories and is compatible with NIIF accounting. +This report details VAT tax and VAT withholding for a given period and can be generated monthly or +semi-annually. It includes information about base, tax amounts, and tax codes and can be used for +SRI reporting. -Accounts can be added or deleted according to the company's needs. +.. _localizations/ecuador/ats: -Products -~~~~~~~~ +ATS report +~~~~~~~~~~ -If products have any withholding taxes, they must be configured on the product form. +To enable downloading the ATS :abbr:`ATS (Anexo Transaccional Simplificado)` report in XML format, +:doc:`install ` the *ATS Report* (`l10n_ec_reports_ats`) module. -Go to :menuselection:`Accounting --> Vendors --> Products`. On the :guilabel:`General Information` -tab, specify both :guilabel:`Purchase Taxes` and :guilabel:`Profit Withhold`. +.. note:: + The Ecuadorian *ATS Report* module depends on the previous installation of the *Accounting* app + and the *Ecuadorian EDI module*. -Taxes -~~~~~ +.. _localizations/ecuador/ats-configuration: -The localization module automatically creates and configures taxes. If new taxes need to be created, -it is recommended to base them on the configuration of the existing ones. +Configuration +************* -To manage taxes, navigate to :menuselection:`Accounting --> Configuration --> Taxes`. Depending on -the tax type, the following options may be required for additional configuration: +To issue electronic documents, ensure the company is configured as explained in the +:ref:`electronic invoice ` section. In the :abbr:`ATS (Anexo +Transaccional Simplificado)`, every document generated in Odoo, such as :ref:`invoices +`, :ref:`vendor bills `, +:ref:`sales ` and :ref:`purchases withholdings +`, :ref:`credit notes +`, and :ref:`debit notes `, +is included. -- :guilabel:`Tax Name`: Follows a specific format depending on the tax type: +.. _localizations/ecuador/ats-vendor-bills: - - | **For IVA (Value-Added Tax)**: - | `IVA [percent] (104, [form code] [tax support code] [tax support short name])` - | Example: `IVA 12% (104, RUC [tax support code] IVA)` - - | **For Income Tax Withholding codes**: - | `Code ATS [percent of withhold] [withhold name]` - | Example: `Code ATS 10% Retención a la Fuente` +Vendor bills +^^^^^^^^^^^^ -- :guilabel:`Tax Support`: Configure only for the IVA tax. This option is used to register purchase - withholdings. -- :guilabel:`Code ATS`: Configure only for income tax withholding codes, as it is necessary to - register a withholding. +When generating a :ref:`vendor bill `, register the authorization +number from the vendor's invoice. To do so, go to :menuselection:`Accounting --> Vendors --> Bills` +and select the bill. Then, enter the number from the vendor's invoice in the +:guilabel:`Authorization Number` field. -In the :guilabel:`Definition` tab: +.. _localizations/ecuador/ats-credit-debit-notes: -- :guilabel:`Tax Grids`: Configure the code of a 104 form if it is an IVA tax, and the code of a - 103 form if it is an income tax withholding code. +Credit and debit notes +^^^^^^^^^^^^^^^^^^^^^^ -.. seealso:: - :doc:`Configuring taxes <../accounting/taxes>` +When creating a :ref:`credit ` or :ref:`debit +` note manually or through an import, link it to the sales +invoice it modifies. -Document types -~~~~~~~~~~~~~~ +.. note:: + Some information is required to the documents before downloading the :abbr:`ATS (Anexo + Transaccional Simplificado)` file. For example, add the *Authorization Number* and the *SRI + Payment Method* to documents when needed. -Some accounting transactions like *customer invoices* and *vendor bills* are classified by *document -types*. These are defined by the government fiscal authorities, which in this case is the SRI. +.. _localizations/ecuador/ats-xml-generation: -To access or configure document types, go to :menuselection:`Accounting --> Configuration --> -Document Types`. +XML generation +************** + +To generate the :abbr:`ATS (Anexo Transaccional Simplificado)` report, go to +:menuselection:`Accounting --> Reporting --> Tax Return`. Choose a period for the desired :abbr:`ATS +(Anexo Transaccional Simplificado)` report, then click :guilabel:`ATS`. Then, upload the downloaded +XML file to *DIMM Formularios*. -Each document type can have a unique sequence per journal where it is assigned. As part of the -localization, the document type includes the country in which the document is applicable; also the -data is created automatically when the localization module is installed. +.. note:: + When downloading the :abbr:`ATS (Anexo Transaccional Simplificado)` report, Odoo generates a + warning pop-up alerting the user if a document(s) has missing or incorrect data. Nevertheless, + the XML file can still be downloaded. -The information required for the document types is included by default and doesn't need to be -changed. +.. _localizations/ecuador/accounting: -Workflows -========= +Accounting +========== -Once a company's database is configured, documents can be registered to enable workflows across -Odoo's applications, such as **Accounting**, **Inventory**, and **Sales**. +.. _localizations/ecuador/sales-documents: Sales documents --------------- -Customer invoices -~~~~~~~~~~~~~~~~~ +.. _localizations/ecuador/customer-invoice: -:guilabel:`Customer invoices` are electronic documents that, when validated, are sent to SRI. These -documents can be :doc:`created from your sales order or manually -<../accounting/customer_invoices/overview>`. +Customer invoice +~~~~~~~~~~~~~~~~ -They must contain the following data: +Customer invoices, electronic documents :doc:`created from sales orders or manually +<../accounting/customer_invoices/overview>`, must contain the following data and, once validated, +are sent to the SRI: - :guilabel:`Journal`: Select the option matching the customer invoice's printer point. - :guilabel:`Document Type`: Type the document type in this format: `(01) Invoice`. - :guilabel:`Payment Method (SRI)`: Select how the invoice will be paid. -.. seealso:: - :doc:`Manage customer invoices <../accounting/customer_invoices/overview>` +.. _localizations/ecuador/credit-notes: Customer credit note ~~~~~~~~~~~~~~~~~~~~ -The :doc:`customer credit note <../accounting/customer_invoices/credit_notes>` is an electronic -document that, when validated, is sent to SRI. A validated (posted) invoice is necessary to register -a credit note. - -On the invoice, click :guilabel:`Credit note` and complete the following information in the -:guilabel:`Credit note` window: +:doc:`Customer credit notes <../accounting/customer_invoices/credit_notes>` are electronic +documents sent to the SRI once validated. :ref:`Credit notes +` can only be registered from a validated (posted) +invoice. -- :guilabel:`Reason`: Type the reason for the credit note. -- :guilabel:`Journal`: Select the journal for the reversal. -- :guilabel:`Document Type`: By default, :guilabel:`(04) Credit Note` is selected. -- :guilabel:`Reversal date`: Set the date for the reversal. +Keep the :guilabel:`Document Type` on :guilabel:`(04) Credit Note` in the :guilabel:`Credit note` +window. -Then, click :guilabel:`Reverse` to first review the invoice or click :guilabel:`Reverse and Create -Invoice`. +Filling out a credit note follows the same process as completing an :ref:`invoice +`. .. note:: When creating the first credit note, select :guilabel:`Reverse` and assign the first credit note - number or by default Odoo assigns `NotCr 001-001-000000001` as the first credit note number. + number or, by default, Odoo assigns `NotCr 001-001-000000001` as the first credit note number. -Once the credit note is created, modify :guilabel:`Product` and :guilabel:`Quantity` if needed. Make -sure the correct :guilabel:`Customer`, :guilabel:`Journal`, and :guilabel:`Document Type` are -specified, and the products listed on the :guilabel:`Invoice Lines` tab are configured with the -correct taxes. - -To validate, click :guilabel:`Confirm`. +.. _localizations/ecuador/debit-notes: Customer debit note ~~~~~~~~~~~~~~~~~~~ -The :ref:`customer debit note ` is an electronic document -that, when validated, is sent to SRI. - -A validated (posted) invoice is necessary to register a debit note. Select the related invoice to -issue a debit note in the :guilabel:`Invoices` list view, click :icon:`fa-cog` :guilabel:`Actions` -and select :guilabel:`Create Debit Note`. Then, complete the following information in the -:guilabel:`Create Debit Note` window. +:ref:`Customer debit notes ` are electronic documents sent +to the SRI once validated. They can only be registered from a validated (posted) invoice. -- :guilabel:`Reason`: Enter the reason for the debit note. -- :guilabel:`Debit note date`: Set the debit note date. -- :guilabel:`Copy lines`: Select this option to register a debit note with the same lines of - invoice. -- :guilabel:`Use Specific Journal`: Select the printer point for your credit note, or leave it empty - to use the same journal as the original invoice. +In the :guilabel:`Use Specific Journal` of the :guilabel:`Create Debit Note` window, select the +printer point for the credit note or leave it empty to use the same journal as the original +invoice. -Then, click :guilabel:`Create Debit Note`. - -The debit note amount can be changed, if desired. +.. _localizations/ecuador/customer-withholdings: Customer withholding ~~~~~~~~~~~~~~~~~~~~ -The :guilabel:`Customer withholding` is a non-electronic document issued by the client in order to -apply a withholding to a sale. +:guilabel:`Customer withholdings` are non-electronic documents issued by the client to apply a +withholding to a sale. They can only be registered from a validated (posted) invoice. -A validated (posted) invoice is necessary to register a customer withholding. On the invoice, click -:guilabel:`Add Withhold` and complete the following information in the :guilabel:`Customer -withholding` window: +On the invoice, click :guilabel:`Add Withhold` and complete the following information in the +:guilabel:`Customer withholding` window: - :guilabel:`Document Number`: Enter the withholding number. - :guilabel:`Withhold Lines`: Select the taxes that the customer is withholding. @@ -437,55 +496,50 @@ withholding` window: Before validating the withholding, review that the amounts for each tax are the same as the original document. -Purchase Documents +.. _localizations/ecuador/purchase-documents: + +Purchase documents ------------------ -.. _l10n_ec/vendor-bills: +.. _localizations/ecuador/vendor-bill: Vendor bill ~~~~~~~~~~~ -:doc:`Vendor bills <../accounting/vendor_bills>` are non-electronic documents issued by vendors when -a company generates a purchase. Vendor bills can be created from purchase orders or manually. +:doc:`Vendor bills <../accounting/vendor_bills>`, non-electronic documents created from purchase +orders or manually, require a specific :ref:`vendor bill journal +`. -.. important:: - A vendor bill journal must be created to create vendor bill documents. - -Create a vendor bill journal -**************************** +.. _localizations/ecuador/vendor-bills-journal: -To create a new journal, go to :menuselection:`Accounting --> Configuration --> Journals`, and click -:guilabel:`New`. +Vendor bills journal +******************** -Then, configure the following: +Use the following configuration to set up the vendor bills journal: - Select :guilabel:`Purchase` as the :guilabel:`Type`. - **Do not** tick the :guilabel:`Purchase Liquidations` checkbox. - Add a :guilabel:`Default Expense Account`. -Configure a vendor bill -*********************** - -To configure a vendor bill, make sure also to complete the following Ecuador specific fields: +To configure a vendor bill, make sure also to complete the following Ecuador-specific fields: - :guilabel:`Document Type`: Enter this document type: `(01) Invoice`. - :guilabel:`Document number`: Enter the document number. -- :guilabel:`Payment Method (SRI)`: Select how the vendor bill will be paid. +- :guilabel:`Payment Method (SRI)`: Select how to pay the vendor bill. .. important:: - When creating the purchase withholding, verify that the bases (base amounts) are correct. If you - need to edit the amount of the tax in the :guilabel:`Vendor bill`, click :guilabel:`Edit`. Or, + When creating the purchase withholding, verify that the bases (base amounts) are correct. If the + amount of the tax in the :guilabel:`Vendor bill` needs to be edited, click :guilabel:`Edit`. Or, from the :guilabel:`Journal Items` tab, click :guilabel:`Edit` and set the adjustment as desired. -.. _l10n_ec/purchase-liquidation: +.. _localizations/ecuador/purchase-liquidation: Purchase liquidation ~~~~~~~~~~~~~~~~~~~~ -The *purchase liquidation* is an electronic document that, when validated, is sent to SRI. - -Companies issue them when they make a purchase but the vendor does not provide an invoice, due to -one or more of the following reasons: +*Purchase liquidations* are electronic documents sent to the SRI once they're validated. Companies +issue them when they make a purchase, but the vendor does not provide an invoice due to one or more +of the following reasons: - Non-residents of Ecuador provided services. - Foreign companies provided services without residency or facility in Ecuador. @@ -495,45 +549,65 @@ one or more of the following reasons: relationship (full-time employee). - Members of collegiate bodies have provided services in the exercise of their function. -In these cases, a purchase liquidation journal must be created. +In these cases, a :ref:`purchase liquidation journal +` must be created. + +.. _localizations/ecuador/purchase-liquidation-journal: Create a purchase liquidation journal ************************************* -To create a new journal, go to :menuselection:`Accounting --> Configuration --> Journals`, and click -:guilabel:`New`. +To create a *purchase liquidations* journal, enter the following information: -Then, configure the following: +- :guilabel:`Journal Name`: Enter this format: `[Emission Entity]-[Emission Point] [Document Type]`, + e.g., `001-001 Purchase Liquidations`. +- :guilabel:`Type`: Refers to the journal type. Select :guilabel:`Purchase`. -- Select :guilabel:`Purchase` as the :guilabel:`Type`. -- Tick the :guilabel:`Purchase Liquidations` checkbox. -- Add a :guilabel:`Default Expense Account`. +Once the :guilabel:`Type` is selected, complete the following fields: + +- :guilabel:`Purchase Liquidations`: Tick this checkbox to enable purchase liquidations. +- :guilabel:`Use Documents?`: Enable this option if legal invoicing (invoices, debit/credit notes) + is used, as this is the standard configuration. If not, select the option to record accounting + entries unrelated to legal invoicing documents, such as receipts, tax payments, or journal + entries. +- :guilabel:`Emission Entity`: Enter the facility number. +- :guilabel:`Emission Point`: Enter the printer point. +- :guilabel:`Emission address`: Enter the address of the facility. +- :guilabel:`Short Code`: Enter a unique 5-digit code for the accounting entry sequence (e.g., + `PT001`). + +Finally, in the :guilabel:`Advanced Settings` tab, check the :guilabel:`Electronic invoicing` +checkbox to enable sending XML/EDI invoices. + +.. _localizations/ecuador/purchase-liquidation-creation: Create a purchase liquidation ***************************** -These types of electronic documents can be created from the *purchase order* or manually from the -*vendor bills* form. Purchase liquidations must contain the following data: +Purchase liquidations, created from *purchase orders* or manually from *vendor bills*, must contain +the following data: - :guilabel:`Vendor`: Enter the vendor's information. - :guilabel:`Journal`: Select the :guilabel:`Purchase Liquidation` journal with the correct printer point. -- :guilabel:`Document Type`: Enter this document type: `(03) Purchase Liquidation` +- :guilabel:`Document Type`: Enter this document type: `(03) Purchase Liquidation`. - :guilabel:`Document number`: Enter the document number (sequence). This must only be entered once, and the sequence will automatically be assigned to the subsequent documents. -- :guilabel:`Payment Method (SRI)`: Select how the invoice is going to be paid. +- :guilabel:`Payment Method (SRI)`: Select how to pay the invoice. - :guilabel:`Products`: Specify the product with the correct taxes. -Once the information has been reviewed, validate the :guilabel:`Purchase Liquidation`. +Then, validate the :guilabel:`Purchase Liquidation`. + +.. _localizations/ecuador/purchase-withholding: Purchase withholding ~~~~~~~~~~~~~~~~~~~~ -The *Purchase withholding* is an electronic document that, when validated, is sent to SRI. +*Purchase withholdings* are electronic documents sent to the SRI once they're validated. They can +only be registered from a validated (posted) invoice. -An invoice in a validated state is necessary before registering a :guilabel:`Purchase withholding`. On the invoice, click :guilabel:`Add Withhold` and complete the following fields in the -:guilabel:`Withholding` window: +:guilabel:`Withhold` window: - :guilabel:`Document number`: Enter the document number (sequence). This must only be entered once, and the sequence will automatically be assigned for the next documents. @@ -548,26 +622,28 @@ Then, validate the :guilabel:`Withholding`. applied on the :guilabel:`Vendor Bill` and change the :guilabel:`Tax Support` there. A withholding tax can be divided into two or more lines, depending on whether two or more -withholdings percentages apply. +withholding percentages apply. .. example:: - The system suggests a VAT withholding of 30% with tax support 01. VAT withholding of 70% can be - added in a new line with the same tax support. Odoo allows it if the base total matches the + Odoo suggests a VAT withholding of 30% with tax support 01. VAT withholding of 70% can be added + to a new line with the same tax support. Odoo allows it if the base total matches the :guilabel:`Vendor Bill`'s total. +.. _localizations/ecuador/expense reimbursement: + Expense reimbursement --------------------- Expense reimbursements apply to the following cases: -- :guilabel:`Individual`: reimbursement to an employee for miscellaneous expenses (e.g. purchase +- :guilabel:`Individual`: reimbursement to an employee for miscellaneous expenses (e.g., purchase liquidations) - :guilabel:`Legal Entity`: reimbursement for incurred expenses, such as representation expenses - (e.g. hiring a lawyer) + (e.g., hiring a lawyer) -To enable an expense reimbursement, make sure a :ref:`purchase liquidation journal -` has been created for an individual or a :ref:`vendor bills journal -` for a legal entity. +To enable expense reimbursement, make sure a :ref:`purchase liquidation journal +` has been created for an individual or a :ref:`vendor +bills journal ` for a legal entity. .. note:: In the vendor bills journal, be sure the following necessary configurations are set for a legal @@ -577,9 +653,9 @@ To enable an expense reimbursement, make sure a :ref:`purchase liquidation journ - **Do not** tick the :guilabel:`Purchase Liquidations` checkbox. - Add a :guilabel:`Default Expense Account`. -Next, to create a reimbursement, :ref:`create a vendor bill ` using the -*purchase liquidation* or *vendor bills* journal. On the vendor bill, configure the following -fields: +Next, to create a reimbursement, :ref:`create a vendor bill ` +using the *purchase liquidation* or *vendor bills* journal. On the vendor bill, configure the +following fields: - :guilabel:`Vendor`: This field should be an employee. - :guilabel:`Document Type`: Verify that this field is accurately populated from the journal. @@ -602,10 +678,110 @@ vendor bill includes the reimbursement information. .. image:: ecuador/l10n-ec-individual-flow.png :alt: Expense Reimbursement. +.. _localizations/ecuador/electronic-delivery-guide: + +Electronic delivery guide +------------------------- + +An *Electronic Delivery Guide* in Ecuador is a legal document that supports the transportation of +goods or merchandise from one place to another within the national territory. It is issued by the +sender of the goods and aims to record and justify the movement of products to avoid legal or tax +issues. It is a fiscal requirement mandated by the *Internal Revenue Service (SRI)*. + +.. important:: + Make sure to :doc:`install ` the :guilabel:`Ecuadorian + Delivery Guide` (`l10n_ec_edi_stock`) module. + +.. _localizations/ecuador/transporter: + +Transporter +~~~~~~~~~~~ + +To create a new carrier (transporter), first :doc:`create a new contact <../../essentials/contacts>` +and fill out the contact information as a :guilabel:`Company`. Make sure the following fields are +complete: + +- :guilabel:`Identification Number`: Select :guilabel:`RUC` and type the carrier's RUC number. +- :guilabel:`SRI Taxpayer Type`: Select :guilabel:`Companies - Legal Entities` as the partner + position in the tax pyramid to automate the computation of VAT withholdings. + +.. image:: ecuador/l10n-ec-carrier-contact.png + :alt: Configuration of a carrier contact. + +.. _localizations/ecuador/certificate-file: + +Certificate file for SRI +~~~~~~~~~~~~~~~~~~~~~~~~ + +To upload the certificate file for SRI, go to :menuselection:`Accounting --> Configuration --> +Settings`, scroll to the :guilabel:`Ecuadorian Localization` section, and click +:icon:`oi-arrow-right` :guilabel:`SRI Certificates` in the :guilabel:`SRI Connection` section. Then, +to create a new certificate, click :guilabel:`New` and fill out the following fields: + +- :guilabel:`Name`: The title of the certificate. +- :guilabel:`Certificate`: Use the :guilabel:`Upload your file` button to upload the SRI + certificate. +- :guilabel:`Certificate Password`: Include the password to decrypt the PKS file if required. + +Once the certificate is created, click :guilabel:`Settings` to go back to the settings and ensure +the certificate is selected in the :guilabel:`Certificate file for SRI` field and the :guilabel:`Use +production servers` checkbox is ticked. + +.. _localizations/ecuador/warehouse configuration: + +Warehouse configuration +~~~~~~~~~~~~~~~~~~~~~~~ + +To configure a warehouse, first :doc:`create a new warehouse +<../../inventory_and_mrp/inventory/warehouses_storage/inventory_management/warehouses>`. Enter the +following data for each warehouse that generates an electronic delivery guide: + +- :guilabel:`Entity Point`: the emission entity number given by the SRI +- :guilabel:`Emission Point`: the emission point number given by the SRI +- :guilabel:`Next Delivery Guide Number`: the forwarding tracking number (editable after first + saving the warehouse). + +.. _localizations/ecuador/generate-electronic-delivery: + +Generate an electronic delivery guide +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +Once the :doc:`delivery <../../inventory_and_mrp/inventory/shipping_receiving/setup_configuration>` +from inventory is created during the sales workflow, make sure the following fields are complete in +the :guilabel:`Delivery Guide` section on the :guilabel:`Additional info` tab: + +- :guilabel:`Transporter`: Enter the :ref:`contact ` created. +- :guilabel:`Plate Number`: Enter the vehicle plate number. +- :guilabel:`Transfer Reason`: By default, :guilabel:`Goods dispatch` is set; modify as needed. +- :guilabel:`Start date`: Automatically set to the creation date (editable). +- :guilabel:`End date`: Automatically set to 15 days after the start date (editable). + +.. image:: ecuador/l10n-ec-delivery-guide-settings.png + :alt: Delivery Guide Settings. + +Click :guilabel:`Validate`, then :guilabel:`Generate Delivery Guide`. Subsequently, the following +information will be available in the :guilabel:`Delivery Guide` section: + +- :guilabel:`Authorization date`: date on which the government authorizes the document. +- :guilabel:`Authorization number`: EDI authorization number (same as access key). +- :guilabel:`Delivery Guide Status`: status of the delivery guide. + +.. image:: ecuador/l10n-ec-authorization-number.png + :alt: Authorization number. + +To receive the XML and PDF, an email can be sent to the contact used in the :guilabel:`Delivery +Address` field - this is an optional and manual step; the :guilabel:`Send Email` button needs to be +clicked. + +.. image:: ecuador/l10n-ec-delivery-guide-pdf.png + :alt: Delivery Guide PDF. + +.. _localizations/ecuador/ecommerce: + eCommerce ---------- +========= -The :ref:`ATS Report module ` enables the following: +The :ref:`ATS Report module ` enables the following: - Choose the *SRI Payment Method* for each payment method's configuration. - Customers can manually input their identification type and number during eCommerce checkout. @@ -614,8 +790,10 @@ The :ref:`ATS Report module ` enables the following: .. seealso:: :doc:`eCommerce documentation <../../websites/ecommerce>` +.. _localizations/ecuador/online-payments: + Online payments -~~~~~~~~~~~~~~~ +--------------- To enable online payments, add the relevant :doc:`payment provider(s) <../payment_providers>` and configure the necessary :ref:`payment methods `. It is mandatory @@ -626,62 +804,68 @@ to set the :guilabel:`SRI Payment Method` for each method. invoice from an eCommerce sale. Select a **payment method** to access its configuration menu and field. +.. _localizations/ecuador/automatic-invoice: + Automatic invoice -~~~~~~~~~~~~~~~~~ +----------------- -To generate an invoice after the checkout process, navigate to :menuselection:`Website --> -Configuration --> Settings` and activate the :guilabel:`Automatic Invoice` option found under the -:guilabel:`Invoicing` section. +:ref:`Invoices ` can be generated after the checkout process. .. tip:: The invoice's email template can be modified from the :guilabel:`Invoice Email Template` field under the :guilabel:`Automatic Invoice` option. .. important:: - The sales journal used for invoicing is the first in the sequence of priority in the + The sales journal used for invoicing is the first in the priority sequence in the :guilabel:`Journal` menu. -eCommerce workflow -~~~~~~~~~~~~~~~~~~ +.. _localizations/ecuador/ecommerce-workflow: Identification type and number -****************************** +------------------------------ -The client who is making a purchase will have the option to indicate their identification type and -number during the checkout process. This information is required to correctly generate the -electronic invoice after the checkout is completed. +During the checkout process, the client making a purchase will have the option to indicate their +identification type and number. This information is required to generate the electronic invoice +after the checkout is completed correctly. .. note:: Verification is done to ensure the :guilabel:`Identification Number` field is completed and has - the correct number of digits. For RUC identification, 13 digits are required. For Cédula, 9 + the correct number of digits. For RUC identification, 13 digits are required, and for Cédula, 9 digits are required. After finishing the checkout process, a confirmed invoice is generated, ready to be sent manually or asynchronously to the SRI. +.. _localizations/ecuador/point-of-sale: + Point of sale electronic invoicing ----------------------------------- +================================== Make sure the *Ecuadorian module for Point of Sale* (`l10n_ec_edi_pos`) is :ref:`installed -` to enable the following features and configurations: +` to enable the following features and configurations: - Choose the SRI payment method in each payment method configuration. -- Manually input the customer's identification type and identification number when creating a new - contact on *POS*. +- Manually input the customer's identification type and number when creating a new contact on *POS*. - Automatically generate a valid electronic invoice for Ecuador at the end of the checkout process. +.. _localizations/ecuador/payment-method-configuration: + Payment method configuration -~~~~~~~~~~~~~~~~~~~~~~~~~~~~ +---------------------------- To :doc:`create a payment method for a point of sale <../../sales/point_of_sale/payment_methods>`, go to :menuselection:`Point of Sale --> Configuration --> Payment Methods`. Then, set the :guilabel:`SRI Payment Method` in the payment method form. +.. _localizations/ecuador/invoicing-flow: + Invoicing flows -~~~~~~~~~~~~~~~ +--------------- + +.. _localizations/ecuador/identification-type-number: Identification type and number -****************************** +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ The P0S cashier can :ref:`create a new contact for a customer ` who requests an invoice from an open POS session. @@ -691,23 +875,27 @@ The *Ecuadorian Module for Point of Sale* adds two new fields to the contact cre .. note:: As the identification number length differs depending on the identification type, Odoo - automatically checks the :guilabel:`Tax ID` field upon saving the contact form. To manually + automatically checks the :guilabel:`Tax ID` field when saving the contact form. To manually ensure the length is correct, know that the :guilabel:`RUC` and :guilabel:`Citizenship` types require 13 and 10 digits, respectively. +.. _localizations/ecuador/anonymous-end-consumer: + Electronic invoice: anonymous end consumer -****************************************** +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ When clients do not request an electronic invoice for their purchase, Odoo automatically sets the customer as :guilabel:`Consumidor Final` and generates an electronic invoice anyway. .. note:: If the client requests a credit note due to a return of this type of purchase, the credit note - should be made using the client's real contact information. Credit notes cannot be created to + should be made using the client's real contact information. Credit notes cannot be created for *Consumidor Final* and can be managed :ref:`directly from the POS session `. +.. _localizations/ecuador/specific-customer: + Electronic invoice: specific customer -************************************* +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ If a customer requests an invoice for their purchase, it is possible to select or create a contact with their fiscal information. This ensures the invoice is generated with accurate customer details. @@ -715,80 +903,3 @@ with their fiscal information. This ensures the invoice is generated with accura .. note:: If the client requests a credit note due to a return of this type of purchase, the credit note and return process can be managed :ref:`directly from the POS session `. - -Financial reports -================= - -In Ecuador, there are fiscal reports that the company presents to SRI. Odoo supports two of the main -financial reports used by companies: **reports 103** and **104**. - -To get these reports, go to :menuselection:`Accounting --> Reporting --> Tax Return`. Click the -:icon:`fa-book` :guilabel:`Report:` icon and select `103 (EC)` or `104 (EC)`. - -Report 103 ----------- - -This report provides details on income tax withholdings in a given period and can be reported -monthly or semi-annually. It includes information about base, tax amounts, and tax codes, and can be -used for SRI reporting. - -Report 104 ----------- - -This report provides details on VAT tax and VAT withholding for a given period and can be generated -monthly or semi-annually. It includes information about base, tax amounts, and tax codes, and can be -used for SRI reporting. - -.. _l10n_ec/ats: - -ATS report ----------- - -:ref:`Install ` the *ATS Report* (`l10n_ec_reports_ats`) module to enable -downloading the ATS report in XML format. - -.. note:: - The Ecuadorian *ATS Report* module depends on the previous installation of the *Accounting* app - and the *Ecuadorian EDI module*. - -Configuration -~~~~~~~~~~~~~ - -To issue electronic documents, ensure the company is configured as explained in the -:ref:`electronic invoice ` section. - -In the :abbr:`ATS (Anexo Transaccional Simplificado)`, every document generated in Odoo (invoices, -vendor bills, sales and purchases withholdings, credit notes, and debit notes) will be included. - -Vendor bills -************ - -When generating a vendor bill, it is necessary to register the authorization number from the -vendor's invoice. To do so, go to :menuselection:`Accounting --> Vendors --> Bills` and select the -bill. Then, enter the number from the vendor's invoice in the :guilabel:`Authorization Number` -field. - -Credit and debit notes -********************** - -When generating a credit note or debit note manually or through an import, it is necessary to link -this note to the sales invoice that is being modified by it. - -.. note:: - Remember to add all required information to the documents before downloading the :abbr:`ATS - (Anexo Transaccional Simplificado)` file. For example, add the *Authorization Number* and the - *SRI Payment Method* on documents, when needed. - -XML generation -~~~~~~~~~~~~~~ - -To generate the :abbr:`ATS (Anexo Transaccional Simplificado)` report, go to -:menuselection:`Accounting --> Reporting --> Tax Return`. Choose a time period for the desired -:abbr:`ATS (Anexo Transaccional Simplificado)` report, then click :guilabel:`ATS`. - -The downloaded XML file is ready to be uploaded to *DIMM Formularios*. - -.. note:: - When downloading the :abbr:`ATS (Anexo Transaccional Simplificado)` report, Odoo generates a - warning pop-up alerting the user if a document(s) has missing or incorrect data. Nevertheless, - the XML file can still be downloaded. diff --git a/content/applications/finance/fiscal_localizations/ecuador/l10n-ec-authorization-number.png b/content/applications/finance/fiscal_localizations/ecuador/l10n-ec-authorization-number.png new file mode 100644 index 0000000000..54d6cf903a Binary files /dev/null and b/content/applications/finance/fiscal_localizations/ecuador/l10n-ec-authorization-number.png differ diff --git a/content/applications/finance/fiscal_localizations/ecuador/l10n-ec-carrier-contact.png b/content/applications/finance/fiscal_localizations/ecuador/l10n-ec-carrier-contact.png new file mode 100644 index 0000000000..b9c5ff5c98 Binary files /dev/null and b/content/applications/finance/fiscal_localizations/ecuador/l10n-ec-carrier-contact.png differ diff --git a/content/applications/finance/fiscal_localizations/ecuador/l10n-ec-delivery-guide-pdf.png b/content/applications/finance/fiscal_localizations/ecuador/l10n-ec-delivery-guide-pdf.png new file mode 100644 index 0000000000..34da7e27c5 Binary files /dev/null and b/content/applications/finance/fiscal_localizations/ecuador/l10n-ec-delivery-guide-pdf.png differ diff --git a/content/applications/finance/fiscal_localizations/ecuador/l10n-ec-delivery-guide-settings.png b/content/applications/finance/fiscal_localizations/ecuador/l10n-ec-delivery-guide-settings.png new file mode 100644 index 0000000000..7fdd1e201f Binary files /dev/null and b/content/applications/finance/fiscal_localizations/ecuador/l10n-ec-delivery-guide-settings.png differ