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

# FileXpress en El Salvador

> Cómo funciona la facturación electrónica (DTE), los impuestos, la invalidación y los libros de IVA en sucursales de El Salvador

En El Salvador FileXpress emite **Documentos Tributarios Electrónicos (DTE)**: cada documento se arma, se **firma** y se **transmite al Ministerio de Hacienda** en el momento de guardar la venta. Hacienda responde en la misma operación con el **sello de recepción** (o rechaza el documento).

> [!NOTE]
>
> Esta página describe lo que cambia en las **sucursales de El Salvador**. Cada sucursal usa las reglas de **su país**: tipos de documento, impuestos, formas de pago y libros salen del país de la sucursal activa.

## Resumen

| Tema | En El Salvador |
| - | - |
| **Moneda** | Dólar estadounidense (USD). El DTE siempre se emite en USD. |
| **Zona horaria** | `America/El_Salvador`. |
| **Autoridad tributaria** | Ministerio de Hacienda (MH). |
| **Firma y transmisión** | FileXpress firma el documento con el certificado de tu empresa y lo transmite a Hacienda. |
| **Respuesta de Hacienda** | Inmediata (`PROCESADO` o rechazo). |
| **Impuesto principal** | IVA 13 %. |
| **Anulación** | **Invalidación** ante Hacienda, con motivo y, según el caso, documento de reemplazo. |
| **Modo sin transmitir** | Sí (solo administradores, si la función está habilitada). |
| **Contingencia** | Sí. |

## Versión 1 y versión 2 del DTE

Hacienda publicó la **versión 2** de los DTE y FileXpress soporta las **dos versiones al mismo tiempo**: tú decides cuándo migrar tu empresa y puedes volver a la versión 1. La migración es por empresa (no por tipo de documento) y solo aplica a El Salvador.

> [!WARNING]
>
> Desde el **3 de noviembre de 2026** puedes cambiar a la versión 2 y Hacienda fijó el **1 de diciembre de 2026** como fecha límite para iniciar con ella. Antes de producción debes solicitar y completar las pruebas. Sigue la guía [Migración a DTE v2](https://docs.filexpress.app/docs/sistema/migracion-dte-v2.md).

Con la versión 2 se habilitan, además, dos eventos que se transmiten a Hacienda y reciben su propio sello: el **evento de retorno** y el de **operaciones especiales**. Solo están disponibles en la versión 2: ver [Eventos DTE](https://docs.filexpress.app/docs/ventas/eventos-dte.md).

## Tipos de documento

| Documento | Código | Cuándo usarlo |
| - | - | - |
| **Factura de Consumidor Final** | `FC` (01) | Ventas a personas o empresas que no requieren crédito fiscal. |
| **Comprobante de Crédito Fiscal** | `CCF` (03) | Ventas a contribuyentes inscritos en IVA. Requiere el NRC del cliente. |
| **Nota de Remisión** | `NR` (04) | Traslado de mercadería sin venta. |
| **Nota de Crédito** | `NC` (05) | Disminuye un CCF emitido (devoluciones, descuentos). Se relaciona con el documento original. |
| **Nota de Débito** | `ND` (06) | Aumenta un CCF emitido. Se relaciona con el documento original. |
| **Factura de Exportación** | `FEX` (11) | Ventas al exterior. Sin IVA; pide régimen, incoterm y, con productos físicos, recinto fiscal. |
| **Factura de Sujeto Excluido** | `FSE` (14) | Solo en **compras**: documento que emites a un proveedor que no está obligado a facturar. |
| **Comprobante de Donación** | `CD` (15) | Para organizaciones que reciben donaciones. Ver [Donaciones](https://docs.filexpress.app/docs/ventas/donaciones.md). |

* Los códigos entre paréntesis son los de Hacienda.
* Un mismo tipo puede usarse en ventas, compras o ambos: el CCF, la FC, la NC y la ND sirven en los dos; la FEX y la NR son de ventas; la FSE es de compras.
* Los permisos por tipo de documento se configuran por usuario. Ver [Usuarios](https://docs.filexpress.app/docs/sistema/usuarios.md#permisos-de-documentos).

## Cómo se emite un documento

**1. Registras la venta**

En [Nueva venta](https://docs.filexpress.app/docs/ventas/nueva-venta.md) eliges el tipo de documento, el cliente, los productos y la forma de pago.

**2. FileXpress arma y firma el DTE**

Se genera el **código de generación** (UUID) y el **número de control**, y el documento se firma con el certificado de tu empresa.

**3. Se transmite a Hacienda**

Hacienda valida y devuelve el **sello de recepción**. El documento queda en estado procesado y se envía por correo al cliente (PDF y JSON).

Para transmitir, la empresa necesita en **Configuración especial** la contraseña del certificado y la contraseña del API de Hacienda, y un ambiente: **pruebas** o **producción**. Para ayuda con estas credenciales escribe a [soporte@filexpress.app](mailto:soporte@filexpress.app).

Si Hacienda **rechaza** el documento, la venta no se pierde: queda como **borrador** con el detalle del error y los códigos del intento. Ver [Borradores de venta](https://docs.filexpress.app/docs/ventas/borradores.md). Este guardado automático ocurre solo en El Salvador.

## Numeración

El **número de control** del DTE lo arma FileXpress con el tipo de documento, el establecimiento y el punto de venta registrados en Hacienda, más un correlativo de 15 dígitos:

```text theme={null}
DTE-01-M001P002-000000000000015
```

* Los correlativos se llevan **por punto de venta, tipo de documento, ambiente (pruebas o producción) y año**.
* El código de establecimiento es una letra y tres dígitos (`M001` casa matriz, `S001`, `S002`… sucursales) y el de punto de venta, `P001`, `P002`…
* Cada documento tiene además su **código de generación** (UUID).

Detalle en [Puntos de venta](https://docs.filexpress.app/docs/caja/puntos-de-venta.md) y [Configuración](https://docs.filexpress.app/docs/sistema/configuracion.md).

## Impuestos

Los impuestos del catálogo de El Salvador son:

| Impuesto | Código | Cómo se calcula |
| - | - | - |
| **IVA** | `20` | 13 % sobre el precio de los productos gravados. |
| **FOVIAL** | `D1` | Monto fijo por unidad vendida. Se suma al documento. |
| **COTRANS** | `C8` | Monto fijo por unidad. Se suma al documento. |
| **Retención 1 %** | — | Se descuenta al cobrar. Ver abajo. |
| **Renta 10 % (sujeto excluido)** | — | Retención en compras a sujetos excluidos. Ver abajo. |

Cada producto es **gravado**, **exento** o **no sujeto** y el resumen de la venta separa los tres. Los clientes marcados como **exentos de IVA** compran sin impuesto, y en la **FEX** no se cobra IVA. Ver [Impuestos en productos](https://docs.filexpress.app/docs/productos/impuestos.md).

### Retenciones automáticas

FileXpress aplica estas reglas según el cliente o proveedor y el tipo de documento:

| Operación | Cuándo se aplica | Tasa |
| - | - | - |
| **Venta** (CCF y FC) | El cliente es **empresa grande** y la venta gravada llega a **\$100**, o el cliente es **institución pública** (sin monto mínimo). | 1 % |
| **Compra** (CCF y FC) | El proveedor es **empresa grande** y la compra gravada llega a **\$100**. | 1 % |
| **Compra a sujeto excluido** (FSE) | Servicios comprados a una persona individual. | 10 % |

> [!NOTE]
>
> En el catálogo esta retención se llama «Retención Renta 1%»; en el DTE viaja en el campo de retención de IVA 1 % y se reporta en el libro **Retención de IVA 1%**. Para marcar a un cliente como empresa grande o institución pública, edita su ficha en [Clientes](https://docs.filexpress.app/docs/ventas/clientes.md).

## Formas de pago

| Código | Forma de pago |
| - | - |
| 01 | Billetes y monedas (efectivo) |
| 02 | Tarjeta de débito |
| 03 | Tarjeta de crédito |
| 04 | Cheque |
| 05 | Transferencia – depósito bancario |
| 11 | Bitcoin |
| 12 | Otras criptomonedas |

Al guardar eliges **Contado** o **Crédito** (con los días de plazo) y puedes combinar varias formas de pago. La FC, el CCF y la FEX piden la forma de pago.

## Clientes y proveedores

| Dato | Detalle |
| - | - |
| **Tipo de cliente** | Persona individual (`non-business`), persona natural (`natural`) o persona jurídica (`legal`). |
| **Documento de identidad** | DUI (13), NIT (36), Pasaporte (03), Carné de residente (02) u Otro (37). |
| **NIT y NRC** | El **CCF** requiere el NRC del cliente. |
| **Actividad económica y tamaño de empresa** | El tamaño (grande, mediano, pequeño) define las retenciones automáticas. |
| **Departamento y municipio** | Se eligen de un catálogo. |
| **Distrito** | Obligatorio en la sucursal para usar la versión 2; en clientes y proveedores se recomienda. |

Los formularios de El Salvador son **fijos**: no se pueden ocultar ni volver opcionales campos desde **Campos por país**.

## Invalidación (anulación)

En El Salvador un DTE transmitido **no se edita ni se elimina: se invalida** ante Hacienda.

**1. En el listado de ventas, abre el menú de acciones y elige Invalidar DTE**

**2. Elige el motivo**

**Error en la información** (indica el DTE que lo reemplaza), **rescindir la operación** u **otro** (describe la razón).

**3. Ingresa nombre y documento de quien emite y de quien solicita la anulación**

**4. Confirma**

El documento pasa a **Invalidado**, se revierte su inventario y aparece en el libro de Invalidaciones.

Plazos de Hacienda para transmitir la invalidación:

| Documento | Plazo |
| - | - |
| CCF, NC, ND, NR y Comprobante de Donación | 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. |
| FC, FEX y FSE | **3 meses** desde el sello de recepción. |

> [!WARNING]
>
> Un evento transmitido fuera de plazo no recibe sello y el documento conserva su validez. Detalles en [Migración a DTE v2](https://docs.filexpress.app/docs/sistema/migracion-dte-v2.md).

## Libros e informes fiscales

La pantalla **Libros de IVA** muestra los libros de El Salvador: Libro de Ventas a Consumidor Final, Libro de Ventas a Contribuyentes, Libro de Compras, Compras a Sujetos Excluidos, Invalidaciones, Retención de IVA 1 %, Percepción de IVA 1 % y Anticipo a cuenta IVA 2 %. También hay anexos en CSV para cargar en el portal de Hacienda y descargas de **todos los JSON** o **todos los PDF** del período. Ver [Libros de IVA](https://docs.filexpress.app/docs/ventas/libros-iva.md).

## Contingencia y registro sin transmitir

> [accordion] Contingencia
>
> Si Hacienda o el servicio de transmisión no están disponibles, las ventas se registran como **contingencia** (con su motivo) y se transmiten después con **Procesar contingencia**, desde el listado de ventas. Los motivos que reconoce el sistema son: no disponibilidad del sistema de Hacienda, no disponibilidad del sistema del emisor, falla del suministro de internet del emisor y falla del suministro eléctrico del emisor. En **Configuración especial** hay una casilla para indicar si tu empresa soporta facturación en contingencia.

> [accordion] Registrar sin transmitir
>
> Los **administradores** de El Salvador pueden registrar una venta sin firmarla ni transmitirla, si la función está habilitada para el negocio. La venta recibe un correlativo propio (1, 2, 3…) y se marca **Sin transmitir**. Ver [Nueva venta](https://docs.filexpress.app/docs/ventas/nueva-venta.md#registrar-sin-transmitir).

> [accordion] Empresa sin facturación electrónica
>
> Si la empresa tiene la facturación electrónica deshabilitada, las ventas se registran sin transmitir y se pueden editar o eliminar.

## POS, inventario e impresión

* En el [punto de venta](https://docs.filexpress.app/docs/caja/punto-de-venta.md) se emiten **FC** y **CCF**.
* Al invalidar un documento se **revierte el inventario** de la venta.
* El PDF usa las plantillas de El Salvador (dos estilos) y hay formato **ticket** para impresoras térmicas.
* La pestaña **Transmisiones** del detalle de la venta guarda cada llamada a Hacienda (la ven los administradores). Ver [Trazabilidad](https://docs.filexpress.app/docs/gestion/trazabilidad.md).

## Lo que debes tener en cuenta

* Los eventos de **retorno** y **operaciones especiales** requieren la versión 2.
* La migración a la versión 2 es **por empresa**, no por tipo de documento.
* Las facturas ya emitidas conservan la versión con la que se emitieron.

## Ver también

* [Nueva venta](https://docs.filexpress.app/docs/ventas/nueva-venta.md)
* [Libros de IVA](https://docs.filexpress.app/docs/ventas/libros-iva.md)
* [Puntos de venta](https://docs.filexpress.app/docs/caja/puntos-de-venta.md)
* [Migración a DTE v2](https://docs.filexpress.app/docs/sistema/migracion-dte-v2.md) y [Eventos DTE](https://docs.filexpress.app/docs/ventas/eventos-dte.md)
* [Impuestos en productos](https://docs.filexpress.app/docs/productos/impuestos.md)
* [Reglas laborales](https://docs.filexpress.app/docs/rrhh/reglas-laborales.md) y [API: países](https://docs.filexpress.app/docs/api/v2/paises.md)


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