Como Instalar la Localizacion Venezolana en Odoo
Paso a paso para configurar el modulo l10n_ve, plan contable, retenciones de IVA e ISLR, contribuyentes especiales, IGTF y secuencias de facturacion SENIAT.
Antes de empezar: requisitos previos
Configurar la localizacion venezolana no es simplemente instalar un modulo y listo. Hay decisiones previas que afectan todo lo que viene despues. Asegurate de tener esto resuelto:
Version de Odoo
Necesitas Odoo 16 o 17. Las versiones anteriores tienen el modulo l10n_ve pero con limitaciones en el manejo de retenciones y posiciones fiscales. Si estas en Odoo 14 o 15, considera migrar antes de configurar la localizacion — te ahorraras retrabajo.
Edicion (Community vs Enterprise)
El plan contable venezolano funciona en ambas. Pero si tu empresa necesita conciliacion bancaria automatica, reportes financieros avanzados o soporte oficial de Odoo, necesitas Odoo Enterprise.
Permisos de acceso
Necesitas acceso de Administrador con permisos de configuracion contable. En Odoo, esto es el grupo “Contabilidad / Asesor contable” mas el modo desarrollador activado. Sin estos permisos no podras instalar modulos ni configurar impuestos.
Datos fiscales listos
Ten a mano: RIF de la empresa, direccion fiscal completa, numero de contribuyente especial (si aplica), porcentajes de retencion IVA que te corresponden, y la tabla de conceptos ISLR que manejas con tus proveedores.
Configuracion paso a paso
Esta guia asume que ya tienes Odoo instalado y una base de datos limpia (o de pruebas). No hagas estos cambios directamente en produccion sin probar primero. Para referencia oficial, consulta la documentacion de localizaciones fiscales de Odoo.
Activar el modulo l10n_ve
Ve a Ajustes > Aplicaciones y busca “Venezuela” o directamente “l10n_ve”. Instala el modulo Venezuela - Contabilidad. Esto carga automaticamente el plan contable venezolano basado en las normas VEN-NIF, los impuestos de IVA estandar (16%, 8%, exento) y la estructura basica de cuentas.
Ojo: Si ya tenias otro plan contable configurado (por ejemplo, el generico), Odoo no te dejara cambiar. Necesitas una base de datos sin transacciones contables o crear una nueva empresa dentro del mismo Odoo. Este es el error #1 que vemos en empresas que intentan hacerlo solas.
Configurar el plan contable venezolano
El modulo l10n_ve trae un plan contable predeterminado, pero rara vez se usa tal cual. Necesitas adaptarlo a la realidad de tu empresa: agregar cuentas analiticas por centro de costo, crear subcuentas para cada banco, separar cuentas de gastos por departamento, y lo mas importante — configurar las cuentas de retenciones (IVA por pagar retenido, ISLR retenido, IGTF).
Ve a Contabilidad > Configuracion > Plan contable y revisa que las cuentas principales esten correctas. Las cuentas criticas que debes verificar:
- Cuenta 1.1.3.xx - IVA credito fiscal
- Cuenta 2.1.5.xx - IVA debito fiscal
- Cuenta 2.1.5.xx - Retenciones de IVA por pagar
- Cuenta 2.1.5.xx - Retenciones de ISLR por pagar
- Cuenta 1.1.3.xx - Anticipo ISLR (retenciones que te hacen)
- Cuenta 6.x.x.xx - Gasto por IGTF
Configurar retenciones de IVA (75% y 100%)
Las retenciones de IVA en Venezuela funcionan asi: si tu empresa es agente de retencion designado por el SENIAT, debes retener un porcentaje del IVA a tus proveedores al momento del pago. Los porcentajes son 75% para contribuyentes ordinarios y 100% para quienes no estan inscritos en el registro de informacion fiscal.
En Odoo, esto se implementa mediante posiciones fiscales (fiscal positions). Crea dos posiciones fiscales:
Posicion fiscal: Retencion IVA 75%
Mapea el IVA 16% a un impuesto combinado: 16% IVA + retencion del 75% del IVA (12%). La cuenta de retencion debe ser un pasivo corriente (2.1.5.xx).
Posicion fiscal: Retencion IVA 100%
Misma logica pero con el 100%: retenes todo el IVA (16%). Esto genera un comprobante de retencion que debes entregar al proveedor dentro de los primeros 3 dias del mes siguiente.
Trampa comun: Muchos configuran la retencion como un impuesto negativo sobre el total de la factura en lugar del monto del IVA. Esto genera montos incorrectos. La retencion del 75% de IVA al 16% es $12 por cada $100 de base imponible, no $12 del total facturado.
Configurar retenciones de ISLR
Las retenciones de ISLR son mas complejas que las de IVA porque el porcentaje varia segun el concepto de pago. No es lo mismo retener por servicios profesionales (5%) que por alquiler (5%) o por comisiones (sustraendo + porcentaje segun tabla). El Decreto 1808 define todos los conceptos y porcentajes.
En Odoo, cada concepto ISLR se configura como un impuesto de tipo “retencion” con su porcentaje y sustraendo correspondiente. Luego asocias cada concepto al proveedor o a la posicion fiscal correspondiente. Los conceptos mas frecuentes:
- Servicios profesionales (personas naturales): 3% a 5% segun monto
- Servicios profesionales (personas juridicas): 2% a 3%
- Alquiler de bienes inmuebles: 5%
- Comisiones mercantiles: segun tabla progresiva
- Honorarios profesionales: 3% a 5% con sustraendo
- Publicidad y propaganda: 1% a 5%
Configurar contribuyentes especiales
Si tu empresa es contribuyente especial designado por el SENIAT, tienes obligaciones adicionales: eres agente de retencion de IVA, tus periodos de declaracion son quincenales (no mensuales), y debes generar comprobantes de retencion en formato especifico.
En Odoo, esto afecta la configuracion de la empresa (marcar como contribuyente especial), la periodicidad de los reportes fiscales, y la secuencia de numeracion de los comprobantes de retencion. Tambien debes configurar correctamente la fecha de corte quincenal para que los libros de compras y ventas generen los periodos correctos.
Configurar el IGTF
El Impuesto a las Grandes Transacciones Financieras (IGTF) es el impuesto que mas confunde a quienes configuran Odoo en Venezuela. A diferencia del IVA, el IGTF no se aplica sobre la factura sino sobre el pago cuando este se realiza en divisas. Actualmente la alicuota es del 3%.
Esto significa que no puedes configurarlo como un impuesto normal en la linea de factura. Necesitas configurarlo a nivel del metodo de pago: cuando el cliente paga en dolares o euros, se genera automaticamente el cargo del 3% adicional. La cuenta contable debe ser un gasto financiero, no una cuenta de impuestos.
Error frecuente: Configurar el IGTF como un impuesto adicional en la factura. Esto infla el monto de la factura y genera discrepancias con el SENIAT. El IGTF es un impuesto al pago, no a la venta.
Configurar secuencias de facturacion SENIAT
El SENIAT requiere que las facturas lleven un numero de control correlativo y un numero de factura que siga la serie autorizada. En Odoo, esto se configura mediante secuencias (ir.sequence) para cada tipo de documento:
- Facturas de venta: serie y correlativo segun autorizacion SENIAT
- Notas de credito: secuencia independiente
- Notas de debito: secuencia independiente
- Comprobantes de retencion IVA: formato YYYYMM + correlativo
- Comprobantes de retencion ISLR: secuencia anual
Configura esto en Contabilidad > Configuracion > Diarios. Cada diario tiene su propia secuencia. Asegurate de que los prefijos y el padding (cantidad de digitos) coincidan con lo que autorizo el SENIAT para tu empresa.
Lo que sale mal cuando lo haces sin experiencia
Hemos visto estos errores decenas de veces en empresas que configuraron la localizacion por su cuenta o con consultores sin experiencia en normativa venezolana:
Plan contable sin cuentas de retenciones
Instalan l10n_ve pero nunca crean las cuentas auxiliares para retenciones. Cuando empiezan a operar, los asientos quedan descuadrados o usan cuentas genericas que no permiten generar reportes fiscales.
Retenciones calculadas sobre el monto incorrecto
Configuran la retencion de IVA sobre la base imponible en lugar del monto del IVA. O calculan ISLR sobre el total con IVA incluido. Ambos errores generan comprobantes invalidos y diferencias con el SENIAT.
IGTF como impuesto en factura
El IGTF grava el pago en divisas, no la venta. Ponerlo en la factura infla el monto y genera inconsistencias en conciliacion. Debe configurarse a nivel de registro de pago.
Secuencias de facturacion no correlativas
Facturas con saltos en la numeracion o numeros de control duplicados. El SENIAT exige correlativos sin huecos. Si pruebas en produccion y borras facturas, perdiste esos numeros.
No separar ambientes de prueba y produccion
Prueban directamente en la base de datos de produccion. Generan facturas de prueba que consumen numeros de control, asientos contables que ensucian los libros, y datos de prueba mezclados con datos reales.
Lo que recibes con IoniaDev
Puedes intentar configurar todo esto por tu cuenta — la informacion esta aqui arriba. Pero si prefieres que quede bien a la primera y sin dolores de cabeza, esto es lo que hacemos por ti:
Configuracion profesional en 48 horas
Plan contable adaptado a tu empresa, todos los impuestos configurados, posiciones fiscales para cada tipo de proveedor y cliente, y secuencias SENIAT correctas. No un template generico: una configuracion hecha para tu operacion especifica.
Pruebas con escenarios reales
Probamos facturacion con IVA, sin IVA, exenta. Pagos en bolivares y en divisas (con IGTF). Retenciones de IVA al 75% y 100%. Retenciones de ISLR por cada concepto que manejas. Todo validado antes de que toques produccion.
Capacitacion del equipo contable
No basta con configurar: tu equipo necesita saber como crear facturas, aplicar retenciones, generar comprobantes y sacar los libros de compras y ventas. Hacemos sesiones practicas con tu propio Odoo, no con diapositivas genericas.
Soporte 30 dias post-configuracion
El primer mes operando siempre surgen dudas y casos borde. Tienes acceso directo a nuestro equipo para resolver cualquier situacion: un proveedor con configuracion fiscal especial, un tipo de retencion que no habiamos contemplado, un reporte que no cuadra.
Garantia de cumplimiento SENIAT
Si los reportes fiscales generados por Odoo no cumplen con los requerimientos del SENIAT, lo corregimos sin costo adicional. Asi de seguros estamos de nuestro trabajo.
Agendar consulta gratuitaPreguntas frecuentes sobre la localizacion venezolana
Que version de Odoo necesito para la localizacion venezolana?+
La localizacion venezolana (l10n_ve) esta disponible desde Odoo 13 en adelante. Sin embargo, recomendamos Odoo 16 o 17 porque incluyen mejoras significativas en el manejo de retenciones, posiciones fiscales y reportes contables. En versiones anteriores a la 13, necesitaras modulos de terceros de la OCA (Odoo Community Association), lo cual agrega complejidad al mantenimiento.
Puedo usar Odoo Community para la localizacion venezolana o necesito Enterprise?+
El modulo l10n_ve base funciona en ambas ediciones. Sin embargo, Odoo Enterprise incluye el modulo de contabilidad completo con conciliacion bancaria automatica, reportes financieros avanzados y soporte oficial. Para una empresa que necesita cumplir con SENIAT de forma rigurosa, Enterprise es la opcion recomendada porque simplifica enormemente la generacion de reportes fiscales y el manejo de retenciones multiples.
Que pasa si configuro mal las retenciones de IVA o ISLR?+
Una configuracion incorrecta de retenciones genera problemas en cascada: declaraciones del IVA con montos erroneos, comprobantes de retencion invalidos que tus proveedores rechazaran, y discrepancias en la conciliacion con los registros del SENIAT. Corregir esto retroactivamente implica revertir asientos contables, regenerar comprobantes y en el peor caso, rectificar declaraciones fiscales. Por eso insistimos en hacer pruebas exhaustivas antes de ir a produccion.
Como configuro el IGTF (Impuesto a las Grandes Transacciones Financieras) en Odoo?+
El IGTF se configura como un impuesto adicional que aplica sobre pagos en divisas extranjeras. Debes crear el impuesto con la alicuota vigente (actualmente 3%), asociarlo a una posicion fiscal especifica para transacciones en divisas, y configurar la cuenta contable de gasto correspondiente. El punto critico es que el IGTF no aplica al monto de la factura sino al monto del pago en divisa, lo cual requiere configuracion a nivel de metodo de pago, no de producto.
Cuanto tiempo toma configurar la localizacion venezolana completa?+
Una configuracion profesional completa toma entre 2 y 5 dias habiles, dependiendo de la complejidad: empresa con solo IVA estandar puede estar lista en 48 horas. Si manejas retenciones de IVA al 75% y 100%, ISLR con distintos porcentajes por concepto, contribuyente especial con agente de retencion, e IGTF, el proceso es mas extenso. Esto incluye configuracion, pruebas con escenarios reales y validacion de reportes fiscales.
Necesito modulos adicionales fuera de l10n_ve para cumplir con el SENIAT?+
Si. El modulo l10n_ve base solo incluye el plan contable y los impuestos basicos. Para un cumplimiento completo necesitas modulos complementarios de retenciones IVA (withholding), retenciones ISLR, secuencias de facturacion con control fiscal, reportes de libro de compras y ventas, y generacion de archivos TXT para declaracion electronica. Estos modulos generalmente provienen de la OCA o de partners locales que los mantienen actualizados con las normativas vigentes.
Se puede migrar la configuracion fiscal si actualizo la version de Odoo?+
Si, pero requiere atencion. El plan contable, impuestos y posiciones fiscales se migran con las herramientas estandar de Odoo. Sin embargo, los modulos complementarios de retenciones y reportes fiscales necesitan ser actualizados por su desarrollador a la nueva version antes de migrar. Siempre recomendamos hacer la migracion en un ambiente de pruebas y validar todos los reportes fiscales antes de pasarla a produccion.
Deja la localizacion en manos de expertos
Configurar la localizacion venezolana correctamente es la base de toda tu contabilidad en Odoo. Un error aqui se arrastra a cada factura, cada retencion y cada declaracion fiscal. Agenda una consulta gratuita y te mostramos exactamente que necesita tu empresa.