Venezuela: Facturación Digital - Amazing (Factura Fácil)
El conector de la imprenta digital Factura Fácil, de Amazing Global de Venezuela, para la suite MI ERP Facturación Digital Venezuela: emisión síncrona — el número de control SENIAT y el PDF legal vuelven en la misma respuesta — con facturas, notas, guías de despacho y retenciones IVA/ISLR.
Qué obtiene
Factura Fácil es la plataforma de imprenta digital de
Amazing Global de Venezuela, C.A. (RIF J-00137560-0),
autorizada por el SENIAT bajo la Providencia 00102. Este módulo implementa
su proveedor sobre el núcleo MI ERP Facturación Digital
Venezuela (l10n_ve_imprenta_digital): usted carga el
correo y la clave de su cuenta de emisor, elige ambiente de staging o
producción, y Odoo emite directamente contra la API de la imprenta.
Lo distintivo de Factura Fácil es que la emisión es síncrona:
un solo endpoint (crearDocumentoFiscal) recibe los 7 tipos de su
catálogo y la respuesta trae en línea el número de control SENIAT
(controlNumber) y la URL del PDF legal
(invoiceURL) — sin polling ni documentos pendientes. El conector
además captura en cada emisión el rango de numeración asignado
(controlNumberFrom/To) y renueva el token Bearer automáticamente.
El adapter está construido contra la documentación oficial del API (especificación OpenAPI v1.6 publicada por la propia imprenta), con sus validaciones replicadas campo a campo — montos como texto a 2 decimales, fechas ISO, longitudes mínimas y alfabetos permitidos — y probado con tests unitarios contra esa especificación. La certificación en vivo con la imprenta está en curso.
Funciones clave
Autenticación automática por correo/clave
Credenciales del emisor en el formulario del proveedor (visibles
solo para administradores), token Bearer solicitado a
autenticarUsuario y renovado automáticamente; un
rechazo de credenciales se distingue de un token vencido y se
reporta legible, sin reintentos inútiles.
Staging / Producción por URL Credenciales redactadas en payloads
Emisión síncrona en una sola llamada
Un único endpoint crearDocumentoFiscal discriminado
por codigoDocumentoFiscal: la respuesta vuelve con el
número de control SENIAT, la URL del PDF legal y el rango de
numeración asignado — ningún documento queda esperando un polling.
controlNumber en línea Rango From/To capturado
Catálogo de 7 tipos, mapeado y resuelto
Factura, nota de crédito y de débito (con la factura afectada obligatoria que exige la imprenta), guía de despacho y orden de entrega, más retenciones IVA e ISLR. Los códigos del núcleo se traducen al catálogo propio de Factura Fácil sin que usted piense en ello.
NC/ND con documento origen Mapa de catálogos automático
Guías de despacho con transporte
El bloque guiaNotaEntrega viaja completo: chofer y
su documento de identidad, placa y tipo de vehículo, origen y
destino de la mercancía y motivo del traslado tomado de la
configuración del diario de guías.
Chofer y placa Motivo de traslado por diario
Multimoneda, tasa BCV e IGTF
El documento viaja en bolívares con la tasa BCV de referencia, y el IGTF del pago en divisas se informa con su monto y su alícuota, calcado de los ejemplos oficiales del API. Montos normalizados a texto con 2 decimales, como exige la imprenta.
Tasa BCV Descuentos por línea
Retenciones IVA e ISLR
Los comprobantes de retención de la localización venezolana se emiten con su detalle por documento: base, alícuota e impuesto retenido en IVA; concepto, tipo de persona y ubicación en ISLR, con el número de comprobante en el formato AAAAMM que exige la norma.
Ret. IVA · ISLR Detalle por factura
Cómo funciona
1 · Instale el conector
Sobre el núcleo MI ERP Facturación Digital Venezuela; el proveedor Amazing - Factura Fácil aparece listo para configurar.
2 · Cargue credenciales
Correo y clave de su cuenta de emisor en Factura Fácil; elija staging o producción — las URLs vienen precargadas.
3 · Apunte los diarios
Seleccione Amazing - Factura Fácil como imprenta en los diarios de venta, guía y retención.
4 · Emita
Al confirmar, el documento viaja a la imprenta y la misma llamada vuelve con el número de control SENIAT asignado.
5 · Descargue el PDF legal
El botón PDF Fiscal descarga el documento legal — con QR y firma de la imprenta — desde la URL publicada en la respuesta, y queda adjunto en Odoo.
Capturas del producto
Capturas reales del conector funcionando en Odoo 19, sobre la cola y las pantallas del núcleo MI ERP Facturación Digital Venezuela.
El conector de un vistazo
Emisión síncrona contra crearDocumentoFiscal: número de
control SENIAT y PDF legal en la misma respuesta, cableados a Odoo.
Un formulario, toda la conexión
URLs de staging y producción precargadas al elegir el proveedor, correo y clave del emisor visibles solo para administradores, código de compañía (multiempresa) opcional, y las capacidades ajustadas a lo que la imprenta realmente ofrece.
La cola de documentos digitales
Cada emisión queda registrada con su estado, su payload de entrada y salida y su evidencia fiscal. Como Factura Fácil responde en línea, ningún documento queda "enviado" esperando confirmación: o está aceptado con su número de control, o el rechazo se lee completo.
Configuración por diario
Cada diario de venta, guía o retención apunta a su imprenta: puede convivir Factura Fácil con otros proveedores de la suite por compañía, serie o tipo de documento, sin tocar código.
Requisitos y bueno saber
Dependencias
Odoo 19.0 Enterprise con el núcleo
Venezuela: Facturación Digital
(l10n_ve_imprenta_digital, se adquiere por separado),
que a su vez se apoya en la localización
l10n_ve_full de MI ERP.
Contrato con la imprenta
Necesita una cuenta de emisor vigente con Amazing Global (Factura Fácil): correo, clave y su rango de números de control. El ambiente de staging de la imprenta permite validar el flujo antes de pasar a producción.
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 | 29123 |
| Technical Name |
l10n_ve_imprenta_digital_amazing |
| 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