Venezuela: Facturación Digital
Emita facturas, notas de crédito y débito, guías de despacho, retenciones IVA/ISLR y comprobantes ARCV a través de imprentas digitales autorizadas por el SENIAT: número de control automático, cola de envío con reintentos, anulación digital y payloads persistidos como evidencia fiscal.
Qué obtiene
La Providencia SNAT/2024/000102 permite emitir los documentos fiscales venezolanos a través de imprentas digitales autorizadas: la imprenta asigna el número de control, devuelve el documento legal en segundos y el papel desaparece. MI ERP Facturación Digital integra ese flujo directamente en Odoo: se registra la factura como siempre y el módulo se encarga del resto.
El módulo cubre el Catálogo 1 del SENIAT completo: facturas (01), notas de crédito (02), notas de débito (03), guías de despacho (04), comprobantes de retención IVA (05) e ISLR (06) y el comprobante anual de retenciones ARCV (07). Cada documento viaja con IGTF, bimoneda VES/USD (tasa BCV), descuentos por línea y exportación con INCOTERM cuando aplica.
El envío unitario cabalga el flujo nativo Enviar e imprimir de Odoo; el envío masivo usa una cola propia con reintentos automáticos y clave de idempotencia que garantiza cero dobles envíos. Al aceptarse el documento, el número de control de la imprenta se estampa en la factura y el PDF fiscal legal queda a un clic.
account.move.send,
diarios, retenciones de la localización venezolana — para que contabilidad,
impuestos y trazabilidad se comporten exactamente como Odoo espera.
l10n_ve_imprenta_digital_hka).
Funciones clave
Catálogo SENIAT completo (01–07)
Facturas, notas de crédito y débito, guías de despacho, retenciones IVA e ISLR y el comprobante anual ARCV, cada uno generado desde su documento natural de Odoo: la factura, la reversión, el wizard de nota de débito, la guía o el comprobante de retención de la localización.
Factura · NC · ND Guía de despacho Ret. IVA/ISLR · ARCV
Máquina de estados con cola y reintentos
Cada envío es un documento fiscal digital con estados Borrador → En cola → Enviado → Aceptado (o Error / Anulado). El cron procesa la cola, reintenta los fallos transitorios y una clave de idempotencia impide el doble envío aunque coincidan el botón y el cron.
Envío manual o automático al validar Cero dobles envíos
Número de control de la imprenta
En los diarios con facturación digital la secuencia local de número de control se neutraliza: el número que asigna la imprenta se estampa automáticamente en la factura al ser aceptada, sin colisiones con la numeración manual de los demás diarios.
Por diario Rangos de numeración desde Odoo
IGTF, bimoneda y descuentos
El IGTF se declara según el pago en divisas realmente conciliado (3% del monto pagado, no del total), los totales viajan en VES con su equivalente USD a tasa BCV, y los descuentos por línea se informan con precio original, monto y precio final.
IGTF sobre el pago real VES + USD Exportación · INCOTERM
Payloads como evidencia fiscal
Cada llamada a la imprenta guarda el request y el response íntegros (solo se redactan credenciales) vinculados al documento y a la operación: emisión, anulación, consulta de estado, numeración. Bitácora y documentos aceptados son inmutables.
Entrada / salida por operación No se puede borrar
Multi-proveedor por diseño
Arquitectura provider/adapter idéntica a los proveedores de pago de Odoo: el núcleo define la máquina de estados, la cola, los payloads y las operaciones; cada imprenta (The Factory HKA, Unidigital…) es un módulo conector independiente. Incluye proveedor de demostración para probar el flujo completo sin contrato.
Patrón payment.provider Demo incluido
Cómo funciona
1 · Configure la imprenta
Instale un conector (p. ej. The Factory HKA) y cargue las credenciales del contrato.
2 · Habilite el diario
Active Facturación Digital en cada diario de venta, guía o retención y elija el modo de envío.
3 · Facture como siempre
Registre la factura, la nota o la retención con el flujo estándar de Odoo.
4 · Envíe a la imprenta
Con el botón, con Enviar e imprimir o automáticamente por la cola con reintentos.
5 · Documento legal
El número de control se estampa en la factura y el PDF fiscal queda disponible; anule digitalmente si hace falta.
Capturas del producto
Capturas reales del módulo funcionando en Odoo 19 con documentos aceptados por la imprenta digital de pruebas de The Factory HKA.
La suite de un vistazo
Flujo factura → imprenta → número de control, y el Catálogo 1 del SENIAT completo con números de control reales aceptados en vivo.
La factura, aceptada por la imprenta
Pestaña Facturación Digital en la propia factura: estado Aceptado, número de control estampado, historial de envíos por proveedor y los botones PDF Fiscal y Anular Digital en la cabecera. El chatter registra cada paso.
Todos los documentos, en una sola cola
Facturas, notas de crédito y débito, guías de despacho, retenciones y ARCV con su proveedor, número de control y estado — Aceptado en verde, Anulado en gris, errores con su mensaje y reintentos.
El documento fiscal digital
Máquina de estados Borrador → En cola → Enviado → Aceptado, clave de idempotencia, respuesta íntegra de la imprenta (código, mensaje, fecha, URL de consulta con QR) y accesos a payloads, bitácora y documento de origen.
Guías de despacho digitales
Las guías de despacho de la localización venezolana también se emiten digitalmente, con motivo de traslado, conductor, placa y peso — y su propio número de control.
Se activa diario por diario
En cada diario: la imprenta a usar, el modo de envío (manual, al validar o en lote), serie y sucursal, el motivo de traslado por defecto para guías y el responsable que recibe los errores.
Evidencia fiscal de cada llamada
Cada operación contra la imprenta — emisión, estado, anulación, numeración — guarda su JSON de entrada y de salida, el endpoint, el código HTTP y el mensaje, vinculados al documento.
Numeraciones bajo control
Los rangos de números de control asignados por la imprenta se solicitan y consultan desde Odoo, por tipo de documento y serie, con su fecha de asignación.
Requisitos y bueno saber
Dependencias
Odoo 19.0 Enterprise con la localización
venezolana l10n_ve_full de MI ERP y la app Contabilidad
(accountant). El módulo lee de allí RIF, retenciones,
número de control e IGTF.
Conector de imprenta
Para emitir contra una imprenta real necesita además un
conector: MI ERP Facturación Digital: The Factory HKA
(l10n_ve_imprenta_digital_hka) u otro proveedor autorizado.
El núcleo incluye un proveedor demo para validar el flujo.
l10n_ve_full.
GRUPO MI ERP SAS — José Luis Vizcaya López
www.mi-erp.app
| Availability |
Odoo Online
Odoo.sh
On Premise
|
| Odoo Apps Dependencies |
•
Accounting (accountant)
• Discuss (mail) • Invoicing (account) • Contacts (contacts) • Inventory (stock) • Purchase (purchase) |
| Community Apps Dependencies | Show |
| Lines of code | 28627 |
| Technical Name |
l10n_ve_imprenta_digital |
| License | OPL-1 |
| Website | https://www.mi-erp.app |
Odoo Proprietary License v1.0 This software and associated files (the "Software") may only be used (executed, modified, executed after modifications) if you have purchased a valid license from the authors, typically via Odoo Apps, or if you have received a written agreement from the authors of the Software (see the COPYRIGHT file). You may develop Odoo modules that use the Software as a library (typically by depending on it, importing it and using its resources), but without copying any source code or material from the Software. You may distribute those modules under the license of your choice, provided that this license is compatible with the terms of the Odoo Proprietary License (For example: LGPL, MIT, or proprietary licenses similar to this one). It is forbidden to publish, distribute, sublicense, or sell copies of the Software or modified copies of the Software. The above copyright notice and this permission notice must be included in all copies or substantial portions of the Software. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
Please log in to comment on this module