> ## Documentation Index
> Fetch the complete documentation index at: https://docs.filexpress.app/llms.txt
> Use this file to discover all available pages before exploring further.

# Migración a facturación electrónica v2

> Cómo pasar tu empresa de El Salvador a la versión 2 de los documentos tributarios electrónicos, probarla y volver a la versión 1 si lo necesitas

Hacienda publicó la **versión 2** de los documentos tributarios electrónicos (DTE). FileXpress soporta las dos versiones al mismo tiempo: **tú decides cuándo migrar** tu empresa y puedes volver a la versión 1 en cualquier momento. Aplica solo a empresas de **El Salvador**.

> [!WARNING]
>
> **Fechas importantes.** A partir del **3 de noviembre de 2026** tu empresa puede cambiar a la versión 2 desde **Sistema → Configuración avanzada**. Hacienda fijó como **fecha límite el 1 de diciembre de 2026 para iniciar** con la versión 2.

> [!WARNING]
>
> **Migrar no es solo activar un interruptor.** Antes de emitir con la versión 2 en producción debes **solicitar las pruebas en [factura.gob.sv](https://factura.gob.sv)**, **completar las pruebas de la versión 2** con respuesta exitosa de Hacienda y solo entonces **pasar a producción**. Esto toma tiempo: **empieza cuanto antes y no lo dejes para los últimos días de noviembre.**

## El camino completo: de las pruebas a producción

**1. Solicita las pruebas en factura.gob.sv**

Entra al portal de facturación electrónica de Hacienda y solicita las pruebas de la versión 2 para tu empresa. Sin ese paso Hacienda no te recibe documentos de prueba ni te autoriza a emitir. También puedes **contactar a soporte de FileXpress en [soporte@filexpress.app](mailto:soporte@filexpress.app)** para que te acompañemos en la solicitud y en las pruebas.

**2. Prepara FileXpress**

Completa el distrito de tus sucursales (y de tus clientes, proveedores y donantes) y revisa los requisitos en **Sistema → Configuración avanzada**.

**3. Activa la versión 2 con la empresa en ambiente de pruebas**

En la Configuración Especial de la empresa deja el **ambiente de pruebas** y, en **Configuración avanzada**, haz clic en **Migrar a la versión 2**. Todo lo que emitas desde ahí va al ambiente de pruebas de Hacienda.

**4. Completa las pruebas mínimas**

Emite documentos de cada tipo que uses hasta cumplir las **pruebas de transmisión satisfactorias** (con sello de recepción), incluidos los eventos. Mira la tabla de abajo.

**5. Pasa a producción**

Cuando Hacienda confirme tus pruebas, cambia el ambiente de la empresa a **producción**. La versión 2 se mantiene activa. Si usas varias empresas, repite el proceso en cada una.

### Pruebas mínimas que pide Hacienda

El manual funcional 2.0 de Hacienda fija cuántas transmisiones exitosas necesita por tipo de documento. Cumple las de **los documentos que tu empresa emite**; confirma en el portal lo que te exigen a ti.

| Documento | Pruebas mínimas |
| - | - |
| Factura | 90 |
| Comprobante de crédito fiscal | 75 |
| Nota de remisión | 50 |
| Nota de crédito | 50 |
| Nota de débito | 25 |
| Factura de exportación | 90 |
| Factura de sujeto excluido | 25 |
| Comprobante de donación | 25 |
| Cada evento (invalidación, contingencia, retorno, operaciones especiales) | 5 |

> [!NOTE]
>
> Migrar no modifica los documentos que ya emitiste. Solo cambia la forma en que se arman los documentos **nuevos**.

## Qué cambia con la versión 2

| Tema | Cambio |
| - | - |
| **Distrito** | Las direcciones del emisor y del receptor suman el **distrito** (catálogo de Hacienda), además del departamento y el municipio. |
| **Versión de cada documento** | Factura 2, Comprobante de crédito fiscal 4, Nota de remisión 4, Nota de crédito 4, Nota de débito 4, Factura de exportación 3, Factura de sujeto excluido 2, Comprobante de donación 2, Invalidación 3, Contingencia 4. |
| **Notas de crédito y débito** | Detallan el IVA, la percepción y la retención por línea, y el receptor se identifica con tipo y número de documento. Requieren el documento relacionado. |
| **Observaciones** | Todos los documentos llevan el campo de observaciones. |
| **Factura de exportación** | Incluye el tipo de régimen (por ejemplo, exportación definitiva) junto al régimen. |
| **Factura de sujeto excluido y donación** | Cambia la forma de identificar a las partes (en la donación, el emisor es quien recibe la donación y el receptor es el donante). |

Los montos, el IVA por línea, los impuestos especiales y los redondeos se calculan igual que en la versión 1.

## Invalidaciones en la versión 2

El evento de invalidación también pasa a la versión 3 y sigue al **documento** que invalidas: un documento emitido en la versión 1 se invalida con el evento de la versión 1, y uno emitido en la versión 2, con el de la versión 3.

Reglas de Hacienda que debes tener presentes:

| Documento | Fecha del evento | Plazo para transmitir la invalidación |
| - | - | - |
| Comprobante de crédito fiscal, notas de crédito y débito, nota de remisión y comprobante de donación | La misma fecha de generación del documento | Hasta las 23:59:59 del décimo día hábil del mes siguiente al período en que el documento obtuvo su sello |
| Factura, factura de exportación y factura de sujeto excluido | Hasta 3 meses después de la fecha de generación | 3 meses desde el sello de recepción |

* Si el motivo es **error en la información** u **otro**, primero emite y transmite el documento que lo reemplaza: su código de generación va en el evento. Si el motivo es **rescindir la operación**, no hay documento de reemplazo.
* Un evento transmitido fuera de plazo no recibe sello y el documento conserva su validez.
* Los datos de quien **realiza** y de quien **solicita** la invalidación (nombre, tipo y número de documento) son obligatorios.

Los documentos invalidados se imprimen con la marca **INVALIDADO** y el detalle de la invalidación: **fecha del evento**, **momento en que Hacienda la recibió** y **sello de invalidación**, además del motivo.

## Eventos nuevos de la versión 2

Con la versión 2 se habilitan en **Eventos DTE** el evento de retorno y el de operaciones especiales. Ver [Eventos DTE](https://docs.filexpress.app/docs/ventas/eventos-dte.md).

## Antes de migrar

**1. Completa el distrito de tus sucursales**

En **Configuración de la sucursal → General → Datos → Ubicación**, elige el distrito de cada sucursal. Es obligatorio: sin él no podrás activar la versión 2.

**2. Completa el distrito de tus clientes, proveedores y donantes**

No es obligatorio para activar, pero hace que tus documentos salgan exactos. Si falta, el sistema usa el primer distrito del departamento del cliente y lo deja registrado.

**3. Ten presente la fecha límite**

Hacienda fijó el **1 de diciembre de 2026** para iniciar con la versión 2; la fecha se muestra en la pantalla de migración. Las pruebas y la autorización toman tiempo, así que planifica con margen.

## Probar primero en el ambiente de pruebas

Antes de producción, la empresa debe trabajar en el **ambiente de pruebas** con la versión 2 activa (pasos 3 y 4 de [El camino completo](#el-camino-completo-de-las-pruebas-a-producción)). **Nunca** envíes documentos de prueba al ambiente de producción, ni documentos reales al de pruebas.

## Activar la versión 2

**1. Ir a la pantalla de inicio (/start)**

Es la pantalla donde eliges empresa y sucursal.

**2. Abrir la Configuración Especial de la empresa**

Haz clic en el ícono de engranaje junto a la empresa y entra a la pestaña **Configuración avanzada**.

**3. Revisar los requisitos**

En **Facturación electrónica v2 (El Salvador)** se muestran los requisitos pendientes y las advertencias, por ejemplo las sucursales sin distrito.

**4. Migrar a la versión 2**

Haz clic en **Migrar a la versión 2**. Si la empresa ya está en producción, el sistema te pide confirmar que **ya completaste las pruebas de la versión 2 con Hacienda**: no lo confirmes sin haberlas terminado.

> [!WARNING]
>
> Solo un **administrador** puede activar o revertir la versión. Los demás usuarios solo consultan el estado.

## Volver a la versión 1

En la misma pantalla, haz clic en **Volver a la versión 1** y confirma. Desde ese momento los documentos nuevos salen otra vez con la versión 1. Los documentos emitidos con la versión 2 se conservan tal como se emitieron.

## Preguntas frecuentes

> [accordion] ¿Qué pasa con las facturas que ya emití?
>
> No cambian. Conservan la versión con la que se emitieron.

> [accordion] ¿Puedo migrar solo algunos tipos de documento?
>
> No. La migración es por empresa y aplica a todos los tipos de documento a la vez.

> [accordion] No me deja migrar: dice que faltan distritos
>
> Entra a la configuración de cada sucursal listada y elige su distrito.

> [accordion] Mi empresa no es de El Salvador
>
> La migración no aplica: Guatemala y Estados Unidos no usan este esquema.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.