Skip to main content
The Ministry of Finance (Hacienda) published version 2 of the electronic tax documents (DTE). FileXpress supports both versions at the same time: you decide when to migrate your company and you can go back to version 1 at any time. It applies only to El Salvador companies.
Important dates. Starting November 3, 2026 your company can switch to version 2 from System → Advanced settings. Hacienda set December 1, 2026 as the deadline to start with version 2.
Migrating is not just flipping a switch. Before issuing with version 2 in production you must request the tests at factura.gob.sv, complete the version 2 tests with a successful response from Hacienda, and only then go to production. This takes time: start as soon as possible and don’t leave it for the last days of November.

​
The full path: from testing to production

1

Request the tests at factura.gob.sv

Go to Hacienda’s electronic invoicing portal and request the version 2 tests for your company. Without that step Hacienda will not receive test documents from you or authorize you to issue. You can also contact FileXpress support at soporte@filexpress.app so we can guide you through the request and the tests.
2

Prepare FileXpress

Complete the district of your branches (and of your customers, suppliers, and donors) and review the requirements in System → Advanced settings.
3

Turn on version 2 with the company in the test environment

In the company’s Special Settings leave the test environment on and, in Advanced settings, click Migrate to version 2. Everything you issue from there goes to Hacienda’s test environment.
4

Complete the minimum tests

Issue documents of each type you use until you meet the successful transmission tests (with reception seal), including events. See the table below.
5

Go to production

When Hacienda confirms your tests, switch the company’s environment to production. Version 2 stays active. If you use several companies, repeat the process in each one.

​
Minimum tests required by Hacienda

Hacienda’s functional manual 2.0 sets how many successful transmissions it needs per document type. Meet those for the documents your company issues; confirm in the portal what is required of you.
Migrating does not modify the documents you already issued. It only changes how new documents are built.

​
What changes with version 2

Amounts, per-line VAT, special taxes, and rounding are calculated the same as in version 1.

​
Invalidations in version 2

The invalidation event also moves to version 3 and follows the document you invalidate: a document issued in version 1 is invalidated with the version 1 event, and one issued in version 2, with the version 3 one. Hacienda rules to keep in mind:
  • If the reason is error in the information or other, first issue and transmit the replacement document: its generation code goes in the event. If the reason is rescinding the operation, there is no replacement document.
  • An event transmitted late does not receive a seal and the document remains valid.
  • The data of whoever performs and whoever requests the invalidation (name, document type, and number) is mandatory.
Invalidated documents are printed with the INVALIDATED mark and the invalidation detail: event date, time Hacienda received it, and invalidation seal, plus the reason.

​
New events in version 2

With version 2, the return event and the special operations event are enabled in DTE events. See DTE events.

​
Before migrating

1

Complete the district of your branches

In Branch settings → General → Data → Location, choose each branch’s district. It is mandatory: without it you will not be able to turn on version 2.
2

Complete the district of your customers, suppliers, and donors

It is not mandatory to turn it on, but it makes your documents come out accurate. If missing, the system uses the first district of the customer’s department and records that.
3

Keep the deadline in mind

Hacienda set December 1, 2026 to start with version 2; the date is shown on the migration screen. Testing and authorization take time, so plan with margin.

​
Test first in the test environment

Before production, the company must work in the test environment with version 2 active (steps 3 and 4 of The full path). Never send test documents to the production environment, nor real documents to the test one.

​
Turn on version 2

1

Go to the home screen (/start)

It is the screen where you choose company and branch.
2

Open the company's Special Settings

Click the gear icon next to the company and go to the Advanced settings tab.
3

Review the requirements

Under Electronic invoicing v2 (El Salvador) the pending requirements and warnings are shown, for example branches without a district.
4

Migrate to version 2

Click Migrate to version 2. If the company is already in production, the system asks you to confirm that you have already completed the version 2 tests with Hacienda: do not confirm without having finished them.
Only an administrator can turn the version on or revert it. Other users can only view the status.

​
Go back to version 1

On the same screen, click Go back to version 1 and confirm. From that moment new documents are again issued with version 1. Documents issued with version 2 are kept exactly as they were issued.

​
Frequently asked questions

They do not change. They keep the version they were issued with.
No. Migration is per company and applies to all document types at once.
Go to the settings of each listed branch and choose its district.
Migration does not apply: Guatemala and the United States do not use this scheme.