OdooWiki OCA HUB

Electronic Ecuadorian Localization

l10n_ec_account_edi folder_open OCA/l10n-ecuador open_in_new
Account License: AGPL-3

The l10n_ec_account_edi module is a crucial component in the Odoo ecosystem, specifically tailored for businesses operating in Ecuador. This module facilitates Electronic Invoicing compliance with the requirements set forth by the Ecuadorian tax authorities. It streamlines the generation and management of electronic invoices, ensuring adherence to legal standards and promoting efficiency in billing processes.

Features

  • Electronic Invoice Generation: The module enables the automatic generation of electronic invoices in compliance with the Ecuadorian tax regulations. This includes the incorporation of required data fields and formats mandated by the tax authorities.
  • Digital Signature Integration: l10n_ec_account_edi integrates digital signature capabilities into the electronic invoicing process. This ensures the authenticity and integrity of the generated electronic invoices, meeting the legal requirements for electronic documents.
  • Automated Submission: The module streamlines the submission process of electronic invoices to the tax authorities' systems. It automates the communication and transmission of invoice data, reducing manual intervention and minimizing errors.
  • Real-time Validation: Before submission, the module performs real-time validation checks to ensure that the generated electronic invoices comply with the current legal standards. This helps in identifying and rectifying issues proactively.

Known issues

  • The SRI authorization response field numeroAutorizacion normally equals the generated clave de acceso, so the module reuses the single l10n_ec_xml_access_key field instead of keeping a separate l10n_ec_authorization_number field. The SRI value is only persisted when it differs from the generated key (e.g. contingency). If a contingency flow ever returns a divergent authorization number, it overwrites the access key and that divergence is kept as a documented limitation.

auto_awesome What this module does

AI-generated from the code · Odoo 19.0

Lets Ecuadorian companies create, digitally sign and send electronic invoices, purchase liquidations, credit notes and debit notes to the SRI tax authority, and track their authorization status in Odoo.

This module turns standard Odoo invoices into Ecuadorian electronic documents that are signed and sent to the SRI (the Ecuadorian tax service).

  • On sale invoices, purchase liquidations, credit notes and debit notes, Odoo builds the official XML file, checks it against the SRI format, signs it with the company's electronic certificate and sends it to the SRI web service for reception and authorization.
  • Before posting, the system checks that taxes have the required SRI codes, that a payment method for the SRI is set, that the customer and company have an identification number, that the journal has an emission address and that the company has a certificate and XML version configured. It also blocks invoices to the final consumer above a configurable sales limit.
  • Each electronic document stores its access key, authorization date, last sent date, document number, date and customer, visible in a new "XML Electronic Documents" screen under the SRI menu.
  • A new "Electronic Signature Certs" screen under the SRI menu manages certificate files, passwords, expiry dates and validation.
  • Additional free-text information can be attached to a document for the XML.
  • Credit and debit notes automatically carry the original document number, date and authorization as reference.
  • Scheduled jobs notify about certificates close to expiry, list unauthorized documents and email authorized documents to customers (final-consumer documents are marked as sent without email).
  • Printed invoice, credit note, debit note and liquidation reports are adapted to the electronic format.

Depends on

accountaccount_edil10n_ecl10n_ec_base

Required by other modules

l10n_ec_credit_notel10n_ec_delivery_notel10n_ec_withhold

Menus it adds

XML Electronic Documentsmenu_action_move_liquidation_of_purchases_typemenu_action_move_debit_note_typeElectronic Signature Certs
Models and fields (11)
  • res.company · extends an existing modell10n_ec_key_type_id (Certificate File), l10n_ec_invoice_version (Invoice Version xml), l10n_ec_type_environment (Environment type for electronic documents), l10n_ec_debit_note_version (Debit Note Version xml), l10n_ec_credit_note_version (Credit Note Version xml), l10n_ec_liquidation_version (Purchase Liquidation Version xml)
  • account.move · extends an existing modell10n_ec_reason (Refund Reason), l10n_ec_is_edi_doc (Is Ecuadorian Electronic Document), l10n_ec_credit_days (Credit days), l10n_ec_journal_type (Journal Type), l10n_ec_sri_payment_id, l10n_ec_xml_access_key (Access Key(EC)), l10n_latam_internal_type (L10n Latam Internal Type), l10n_ec_authorization_date (Electronic Authorization Date), l10n_ec_legacy_document_date (External Document Date), l10n_ec_legacy_document_number (External Document Number), l10n_ec_electronic_authorization (Electronic Authorization), l10n_ec_legacy_document_authorization (External Authorization Number), l10n_ec_additional_information_move_ids (Additional Information)
  • sri.key.type · new modelname, state, active (Active?), password (Signing key), file_name (Filename), company_id (Company), issue_date (Date of issue), expire_date (Expiration date), cert_version (Version), file_content (Signature File), cert_serial_number (Serial number (certificate)), issuer_common_name (Organization (Issuer)), subject_common_name (Organization(Subject)), days_for_notification (Days for notification), subject_serial_number (Serial Number(Subject))
  • account.move.line · extends an existing model
  • account.move.send · extends an existing model
  • account.debit.note · extends an existing model
  • account.edi.format · extends an existing model
  • res.config.settings · extends an existing modell10n_ec_key_type_id, l10n_ec_ruc_provider (RUC Provider), l10n_ec_invoice_version, l10n_ec_type_environment, l10n_ec_debit_note_version, l10n_ec_credit_note_version, l10n_ec_liquidation_version, l10n_ec_final_consumer_limit (Invoice Sales Limit Final Consumer)
  • account.edi.document · extends an existing modell10n_ec_partner_id (Customer), l10n_ec_document_date (Document Emission Date), l10n_ec_last_sent_date (Last Sent Date), l10n_ec_xml_access_key (Access Key(EC)), l10n_ec_document_number (Document Number), l10n_ec_authorization_date (Authorization Date)
  • account.move.reversal · extends an existing model
  • l10n.ec.additional.information · new modelname, move_id, description

Text generated by AI (DeepSeek) from reading the Odoo 19.0 code on GitHub; it may contain mistakes, so check the code before deciding. The module is very large and only part of the code was read. View the code on GitHub

Availability by version

Reviewed: 2026-11-03
Confirmed (verified in repository and branch) Estimated (unverified) No information

Confirmation status: 3 confirmed, 6 with no information of 9 versions.

Sources · Odoo 15.0

Confirmed on 2026-11-03 in branch 15.0 of OCA/l10n-ecuador.

terminal Installation and usage

OCA documentation · Odoo 19.0

Configuration

Source · Odoo 19.0

To set the RUC of the electronic system provider according to SRI Resolution NAC-DGERCGC26-00000027

  • Go to Invoicing > Configuration > Settings.
  • In the Ecuadorian Localization section, set the RUC Provider.

The SRI authorization number returned by the web service is stored automatically on each authorized electronic document, next to the authorization date. No manual configuration is needed

  • Go to Invoicing > Configuration > Ecuadorian SRI > XML Electronic Documents.
  • Check the Authorization Number(EC) column of the list, or open a document to see it in the form.

Usage

Source · Odoo 19.0

To effectively utilize the l10n_ec_account_edi module, follow these essential steps:

  • Electronic Signature Configuration: Upload your electronic signature in the required .p12 format through the module's configuration settings. Ensure that the provided electronic signature is valid and complies with Ecuadorian regulations.
- Navigate to Invoicing > Settings > Ecuadorian SRI > Electronic Signature Certs.
- Upload your electronic signature file in .p12 format.
  • Company Data Configuration: Input and verify the company's information, including addresses and RUC, to ensure accurate and compliant electronic invoice generation.
- Navigate to Settings > Companies > [Your Company].
- Update company details, addresses, and RUC information.
  • Journal, Agencies, and Emission Points Configuration: Configure the necessary accounting parameters such as journals, agencies, and emission points to align with your business structure and legal requirements.
    - Navigate to Invoicing > Configuration > Accounting > Journals.
    - Set up relevant journals for electronic invoicing.

4. **General Settings:**

    - In the Odoo settings for electronic invoicing, select the uploaded electronic signature and specify the environment (testing or production) for accurate invoice generation and submission.

By completing these configurations, your Odoo instance with the `l10n_ec_account_edi` module will be well-prepared for Electronic Invoicing in Ecuador,

No verified information in OCA: Installation.

info

Data imported from GitHub: this sheet reflects the latest catalog review, not a live lookup. Always check the module documentation and staging before installing in production.