Cómo funciona
- Configuras una vez la API key de sudte, el ambiente (pruebas o producción) y, por diario, el tipo de DTE, el establecimiento y el punto de venta.
- Al confirmar una factura, Odoo la envía a sudte con una clave de idempotencia estable: aunque se reintente, nunca se emiten dos DTE.
- sudte calcula, arma el JSON oficial, lo valida, lo firma con tu certificado y lo transmite al Ministerio de Hacienda.
- La factura muestra el estado del DTE, el número de control, el código de generación y el sello, con el PDF y el JSON adjuntos. sudte envía el correo al cliente.
- Si el MH rechaza el documento, ves el motivo en español y en qué campo está el problema, corriges y reintentas desde la misma factura.
Las notas de crédito y débito se envían con su documento relacionado, y la invalidación se hace desde un asistente que pide el motivo (catálogo CAT-024) y, si corresponde, el documento de reemplazo. Los cambios de estado llegan a Odoo por webhooks firmados.
Qué instalas
| Módulo | Qué aporta |
|---|---|
sudte_l10n_sv | Localización de El Salvador: plan de cuentas mínimo, impuestos (IVA 13 %, retención y percepción 1 %, exento, no sujeto, exportación), posiciones fiscales, departamentos, municipios y distritos, actividades económicas, NIT, NRC y DUI en contactos con validación y control de duplicados, tipo de DTE por diario y unidades de medida CAT-014. |
sudte_connector | Conexión con la API: envío al confirmar, estados, adjuntos, reintentos, consulta de estado, invalidación, notas de crédito y débito, webhooks y menú de reportes fiscales. |
Antes de enviar, el módulo revisa que el contacto tenga lo que el MH exige (por ejemplo, el distrito en la dirección o el NRC sin espacios) y ofrece un asistente para encontrar y corregir los contactos incompletos. Así evitas rechazos por datos maestros, la causa más común en migraciones.
Por qué la lógica fiscal no vive en Odoo
- Cambios de normativa sin reinstalar: cuando el MH publica una nueva versión de esquemas o reglas, se actualiza sudte y tu Odoo sigue igual.
- Sin certificados en tu servidor: la firma ocurre en sudte; Odoo no guarda claves privadas ni contraseñas del MH.
- Un solo motor probado: el mismo que usan el panel, los POS y los integradores, con validación contra el esquema oficial antes de firmar.
- Odoo estándar: no se reemplazan reportes ni diseños de factura; las actualizaciones de Odoo no rompen la facturación electrónica.
Multicompañía, sucursales y un solo NIT
Es común tener varias compañías en Odoo con el mismo NIT (por ejemplo, una por sucursal). En sudte, ese NIT es un único emisor y cada compañía se mapea a su establecimiento. La numeración del número de control es una sola, centralizada o por establecimiento como manda la Normativa, así que no aparecen números de control duplicados entre compañías. Si manejas empresas con NIT distintos, cada una es un emisor dentro de la misma cuenta.
Libros de IVA y anexos, generados por sudte
Los libros de ventas a contribuyentes y a consumidor final, el libro de compras y los anexos para el MH se generan en sudte a partir de tus DTE y de las compras que Odoo sincroniza. Desde Odoo los consultas y descargas en CSV, Excel o PDF, y puedes cerrar un periodo para congelarlo. Esta función está en desarrollo y se incluye en los planes Odoo.
Instalación
- Crea tu cuenta en sudte y registra tu empresa (NIT, NRC, actividad económica, dirección y establecimientos).
- Copia los módulos en tu ruta de addons (o en tu repositorio de Odoo.sh) e instala
sudte_connector. - En Ajustes → Contabilidad → sudte, pega tu API key de pruebas (
sk_test_) y elige el emisor. - Configura en cada diario de ventas el tipo de DTE, el establecimiento y el punto de venta.
- Confirma una factura de prueba y verifica el sello. Cuando el MH te autorice, cambia a la API key de producción (
sk_live_).
La guía detallada está en la documentación del módulo Odoo.
Localización tradicional vs. sudte
| Localización con DTE dentro de Odoo | Odoo + sudte | |
|---|---|---|
| Firma y certificado | En tu servidor de Odoo | En sudte, cifrado con KMS |
| Cambios de normativa | Actualizar e instalar el módulo en cada base de datos | Se actualiza sudte; Odoo no cambia |
| Números de control con varias compañías | Secuencias por compañía, riesgo de duplicados | Una secuencia por NIT |
| PDF del DTE | Reportes QWeb personalizados | PDF oficial generado por sudte |
| Contingencia y reintentos | Tareas programadas en Odoo | Gestionados por sudte |
| Libros de IVA | Reportes dentro del módulo | Generados por sudte, consultados desde Odoo |
Consulta los planes para Odoo, con documentos incluidos y libros de IVA.
Actualizado el 12 de octubre de 2026.