Manual de usuario · Facturación electrónica
Documentos Tributarios Electrónicos (DTE) de El Salvador en Odoo 19
Configuración del certificador, emisión de los once tipos de DTE, receptores, invalidación ante el Ministerio de Hacienda, contingencia y facturación electrónica en el punto de venta.
1.Cómo usar este manual
Qué cubre, para quién está escrito y de dónde salieron las pantallas que ilustran cada paso.
Este manual explica cómo emitir Documentos Tributarios Electrónicos (DTE) de El Salvador desde Odoo 19: cómo se configura el certificador, cómo se emite cada uno de los once tipos de documento, qué hacer cuando el Ministerio de Hacienda rechaza uno, cómo se invalida y cómo funciona todo esto dentro del punto de venta.
Cubre dos módulos que trabajan juntos:
multicert_felsv
El motor. Arma el JSON del DTE, lo envía al certificador, guarda el código de generación, el número de control y el sello de recepción, e implementa invalidaciones, contingencia y reproceso.
pos_multicert_felsv
Lleva el DTE al punto de venta: certifica al cobrar, imprime el ticket con el código QR del Ministerio de Hacienda y permite invalidar o devolver desde la caja.
Está pensado para tres perfiles:
- El cajero o facturador — capítulos 19 a 25 y 30 a 35: emitir, invalidar y devolver.
- El contador — capítulos 23 a 29 y 36: notas, invalidaciones, rechazos, contingencia y monitoreo de lo certificado.
- Quien implementa — capítulos 5 a 18: la lista completa de configuración, campo por campo, con las reglas que el Ministerio valida en cada uno.
1.1 Convenciones
| Elemento | Significado |
|---|---|
| Facturación › Configuración › Diarios | Ruta de menú. Cada › es un clic más adentro. |
fel_sv_uuid |
Nombre técnico de un campo. Sirve para buscarlo en filtros, importaciones o soporte. |
| Certificado | Estado que se ve en pantalla, tal como lo muestra Odoo. |
| DTE | Documento Tributario Electrónico: la factura, el comprobante o la nota ya recibida y sellada por el Ministerio de Hacienda. |
| MH | Ministerio de Hacienda de El Salvador, la administración tributaria. |
Todas las pantallas son reales, tomadas de una base de datos de demostración de la empresa ficticia Comercial Cuscatlán, S.A. de C.V. Los documentos que aparecen certificados se certificaron de verdad, pero contra el ambiente de pruebas del Ministerio de Hacienda: los códigos de generación y los sellos de recepción son auténticos y no tienen ningún valor fiscal. Los NIT y DUI que se ven son identificadores de prueba.
2.Qué es un DTE y cómo funciona
El circuito completo, desde que usted presiona «Confirmar» hasta que el cliente puede verificar su documento en el portal del Ministerio de Hacienda.
Desde 2022 El Salvador sustituyó los documentos preimpresos por el Documento Tributario Electrónico. Bajo ese régimen, un documento no existe legalmente hasta que el Ministerio de Hacienda lo recibe y lo sella, y eso ocurre en el momento mismo de emitirlo, no al final del mes.
2.1 Los actores
| Actor | Papel |
|---|---|
| El emisor | Su empresa. Genera el documento y lo envía. Necesita estar inscrita en el régimen de DTE y tener registrados sus establecimientos y puntos de venta ante el Ministerio, además de su actividad económica. |
| El certificador | Proveedor que firma el documento y lo transmite al Ministerio. Este módulo soporta Infile y DTE Solutions. Le devuelve a usted el sello de recepción. |
| El Ministerio de Hacienda | Recibe, valida y registra el DTE. Publica un verificador público donde cualquiera puede comprobar que un documento existe. |
| El receptor | Su cliente. Se identifica con NIT y NRC si es contribuyente, o con DUI, pasaporte o carnet de residente si es consumidor final. |
2.2 El circuito de un documento
Los cinco pasos ocurren en un solo clic y tardan típicamente entre uno y tres segundos. Si algo falla en el paso 3 o 4 —un dato mal capturado, el certificador caído, la conexión perdida— Odoo no deja el documento a medias: lo detiene, lo publica con el error a la vista o lo pasa a contingencia, según cómo esté configurado. Los capítulos 26 y 27 explican esos tres caminos.
2.3 Los cuatro datos que devuelve el Ministerio
Cuando la recepción tiene éxito, el documento queda marcado con cuatro datos que ya no cambian y que son los que el cliente y el Ministerio reconocen:
| Dato | Campo en Odoo | Qué es |
|---|---|---|
| Código de generación | fel_sv_uuid |
Identificador único universal (UUID) del DTE, en mayúsculas. Es «el número» del documento electrónico y es el que se usa para consultarlo o invalidarlo. |
| Número de control | fel_sv_control_number |
Correlativo con formato DTE-tipo-establecimientopunto de
venta-15 dígitos. Por ejemplo
DTE-03-M001P001-000000000000018. |
| Sello de recepción | fel_sv_seal_reception |
La firma del Ministerio de Hacienda sobre el documento. Sin sello, el DTE no está recibido. |
| Fecha de recepción | fel_sv_date_reception |
Momento exacto en que el Ministerio procesó el documento. |
Odoo numera sus facturas con su propia secuencia (FELSV/2026/00003). El número
de control lo arma el Ministerio con el establecimiento, el punto de venta y un correlativo
propio por tipo de documento. Los dos conviven: el de Odoo sirve para la contabilidad y el de
control para el fisco. En la ficha del documento los verá uno debajo del otro.
2.4 Verificación pública
Todo DTE se puede verificar sin contraseña en
admin.factura.gob.sv/consultaPublica. Odoo arma el enlace con el ambiente, el código
de generación y la fecha de emisión, lo guarda en fel_sv_mh_url y además genera el
código QR que lleva a esa misma dirección. El QR se imprime en la factura y en el ticket de
caja.
Para seguir leyendo, crea tu cuenta
Quedan 38 capítulos más en este manual. Crea tu cuenta y solicita el acceso: lo aprobamos a mano, normalmente el mismo día.