Saltar al contenido

Odoo 20 · El Salvador

Facturación electrónica en Odoo para El Salvador

Confirma la factura en Odoo y recibe en segundos el número de control, el sello de Hacienda, el PDF y el JSON. El módulo de sudte conecta Odoo con la API: toda la lógica fiscal, la firma y los cambios de normativa quedan fuera de tu instalación.

Cómo funciona

  1. 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.
  2. Al confirmar una factura, Odoo la envía a sudte con una clave de idempotencia estable: aunque se reintente, nunca se emiten dos DTE.
  3. sudte calcula, arma el JSON oficial, lo valida, lo firma con tu certificado y lo transmite al Ministerio de Hacienda.
  4. 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.
  5. 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óduloQué 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

  1. Crea tu cuenta en sudte y registra tu empresa (NIT, NRC, actividad económica, dirección y establecimientos).
  2. Copia los módulos en tu ruta de addons (o en tu repositorio de Odoo.sh) e instala sudte_connector.
  3. En Ajustes → Contabilidad → sudte, pega tu API key de pruebas (sk_test_) y elige el emisor.
  4. Configura en cada diario de ventas el tipo de DTE, el establecimiento y el punto de venta.
  5. 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 OdooOdoo + sudte
Firma y certificadoEn tu servidor de OdooEn sudte, cifrado con KMS
Cambios de normativaActualizar e instalar el módulo en cada base de datosSe actualiza sudte; Odoo no cambia
Números de control con varias compañíasSecuencias por compañía, riesgo de duplicadosUna secuencia por NIT
PDF del DTEReportes QWeb personalizadosPDF oficial generado por sudte
Contingencia y reintentosTareas programadas en OdooGestionados por sudte
Libros de IVAReportes dentro del móduloGenerados por sudte, consultados desde Odoo

Consulta los planes para Odoo, con documentos incluidos y libros de IVA.

Actualizado el 12 de octubre de 2026.

FAQ

Preguntas frecuentes

¿Otra duda? Escríbenos a ventas@sudte.com.

¿Funciona en Odoo.sh y en Odoo Online?

En Odoo.sh y en instalaciones propias, sí: son módulos estándar de Odoo 20. Odoo Online (SaaS) no permite instalar módulos de terceros; en ese caso puedes emitir desde el panel de sudte o mediante la API.

¿Qué versiones de Odoo soportan?

Primero Odoo 20 Enterprise. Le siguen Odoo 20 Community y Odoo 18 con el mismo contrato de API, así que la experiencia será idéntica. Si usas otra versión, escríbenos.

¿Tengo que cambiar el diseño de mis facturas en Odoo?

No. El reporte de factura de Odoo queda como viene. La representación gráfica oficial del DTE (PDF con QR y sello) la genera sudte y se adjunta a la factura junto con el JSON firmado.

¿Qué pasa con mis facturas si sudte o Hacienda no responden?

La factura queda confirmada en Odoo con el estado del DTE pendiente. sudte reintenta según la política del MH y Odoo se actualiza solo cuando llega el webhook con el sello. También puedes consultar el estado o reintentar con un botón.

¿Puedo migrar desde otra localización y continuar mis correlativos?

Sí. Al configurar el emisor en sudte indicas el último número de control usado por establecimiento para que la numeración continúe sin saltos ni duplicados.

¿Dónde queda mi certificado de firma?

En sudte, cifrado con AWS KMS. Odoo nunca guarda el certificado, la clave privada ni la contraseña de la API del MH; solo una API key de sudte visible únicamente para administradores.

Conecta tu Odoo con Hacienda

Crea tu cuenta, genera una API key de pruebas y prueba el módulo contra el ambiente de pruebas del MH. Te acompañamos en la autorización como emisor.