¿Listo para implementarlo en tu Odoo?
Agenda una demo o habla con un consultor y resuelve tus dudas antes de comprar. Instalación, configuración y soporte incluidos.
Venezuela: Facturación Digital - Procert (SIGECE)
El conector de la imprenta digital Procert — plataforma SIGECE v2 (imprentadigitalenlinea.com.ve) — para la suite MI ERP Facturación Digital Venezuela: JWT con expiración real, emisión masiva síncrona con número de control inmediato, notas de crédito y débito, anulación, PDF fiscal y conciliación por histórico, construido contra la documentación oficial del API.
Qué obtiene
Procert ITFB, C.A. es Proveedor de Servicios de Certificación
(PSC) acreditado por SUSCERTE e imprenta digital autorizada por el SENIAT bajo
la Providencia SNAT/2024/000102. Su plataforma SIGECE
(Sistema de Gestión de Comprobantes Electrónicos) expone un API REST v2 con
JWT. Este módulo implementa su proveedor sobre el núcleo
MI ERP Facturación Digital Venezuela
(l10n_ve_imprenta_digital): usted carga el email y la clave de su
contrato en el portal SIGECE, elige ambiente de prueba o producción, y Odoo
emite directamente contra el API de la imprenta.
La integración cubre el ciclo completo de facturas y notas: emisión síncrona
por /facturas/masivafacturacion — el body es un array aun
para un solo documento — con systemReferen como clave de
idempotencia y el número de control devuelto en la misma
llamada; notas de crédito y débito por
/facturas/nota/masivanotas referenciando la factura afectada;
anulación de facturas y notas; descarga del PDF fiscal
codificado en base64; y conciliación de estado por el histórico documentado
(/facturas/facturacionHistorico). El token JWT se renueva
automáticamente respetando su expiración real.
SIGECE responde HTTP 200/203 aunque haya documentos rechazados: por eso el
conector nunca confía en el status HTTP — recorre siempre
DetalleFacturaProcesadas y DetalleErrorFacturas y
muestra el detalle de error por documento de forma legible,
marcando los rechazos por datos como no reintentables.
FacturaInput y cada endpoint de SIGECE.
Funciones clave
JWT con expiración real
Email y clave del portal SIGECE en el formulario del proveedor (la
clave, solo para administradores). El token Bearer de
/auth/login se guarda con su expiración real
(tokens.access.expires) y se reutiliza hasta vencer —
clave con el rate limit de 20 llamadas por ventana en
/auth/*. Un 401 de negocio reautentica y reintenta; un
401 del propio login se reporta como credenciales inválidas, sin
reintentos ciegos.
QA / Producción por URL Credenciales redactadas en payloads
Emisión síncrona con control inmediato
El FacturaInput se arma desde los datos fiscales de la
localización venezolana: RIF con formato de la imprenta, IVA por
alícuota, exentos, descuentos por línea, condición de pago
Contado/Crédito, coletilla IGTF y tasa BCV del día
(tipoCambioDiaUsd). El nroControl lo asigna
SIGECE y vuelve en la misma llamada.
Multimoneda VES/USD Montos normalizados a 2 decimales
Idempotencia por systemReferen
Cada documento viaja con su referencia del ERP como
systemReferen, que la imprenta devuelve en
DetalleFacturaProcesadas: el conector concilia por esa
clave (o por número) y el número de documento queda fijado en el
primer intento y se reutiliza en los reintentos —
sin duplicados ante cortes de red.
Conciliación exacta Número fijado y reusado
Errores POR documento, no por HTTP
SIGECE responde 200/203 aunque haya rechazos. El parser recorre
siempre DetalleFacturaProcesadas y
DetalleErrorFacturas — aplanando el array de arrays real
del API — y presenta cada msg de forma legible; los
rechazos por datos del documento quedan marcados como no
reintentables para no insistir en vano.
Detalle legible por documento Payloads persistidos como evidencia
Notas de crédito y débito
Emisión por /facturas/nota/masivanotas referenciando la
factura afectada por su número — el emitido por la propia Procert
cuando la factura salió por ella — con tipoNota
CREDITO/DEBITO, líneas de devolución total o parcial y los gravámenes
en las dos variantes de clave que muestra el spec oficial.
Factura afectada obligatoria Reversión total o parcial
Anulación, PDF y conciliación
Anulación de facturas
(/facturas/anularfactura/{id}) y de notas
(/facturas/nota/anular/{id}); descarga de la
representación gráfica en PDF
(/facturas/queryFacturasCodificada/{id} →
facturaCodificada en base64, adjunta en Odoo); y estado
conciliable en cualquier momento contra el histórico documentado
/facturas/facturacionHistorico.
PDF fiscal base64 Histórico documentado
Cómo funciona
1 · Instale el conector
Sobre el núcleo MI ERP Facturación Digital Venezuela; el proveedor Procert (SIGECE) aparece con las URLs v2 de QA y producción precargadas.
2 · Cargue credenciales
Email y clave del portal SIGECE (imprentadigitalenlinea.com.ve); elija ambiente Prueba o Habilitado (producción).
3 · Apunte los diarios
Seleccione Procert (SIGECE) como imprenta en sus diarios de venta; puede convivir con otras imprentas de la suite en otros diarios.
4 · Emita
Facturas y notas de crédito/débito llegan a SIGECE y vuelven con su número de control en la misma llamada.
5 · Concilie
Estado contra el histórico, PDF fiscal adjunto en la factura y anulación con motivo auditado cuando haga falta.
Capturas del producto
Capturas reales del conector en Odoo 19 sobre el núcleo MI ERP Facturación Digital Venezuela.
El conector de un vistazo
El API SIGECE v2 de Procert cableado a Odoo: emisión por
/facturas/masivafacturacion, notas, anulación, PDF fiscal
e histórico, sobre la cola y la máquina de estados del núcleo.
Un formulario, toda la conexión
Ambiente Deshabilitado → Prueba → Habilitado, URLs v2 de QA y producción precargadas (dominios distintos, ya resueltos por el conector), email y clave del portal SIGECE — solo visibles para administradores — y el token JWT gestionado automáticamente con su expiración real.
Cada documento, con su ciclo de vida
La cola de documentos del núcleo: cada factura o nota genera un documento digital con máquina de estados, reintentos con backoff y payloads de entrada/salida persistidos como evidencia fiscal — con las llamadas a SIGECE registradas una a una.
La imprenta se elige por diario
Cada diario de venta apunta a su imprenta digital: Procert (SIGECE) puede convivir con los demás conectores de la suite, incluso en la misma compañía, y migrar de imprenta es cambiar el diario.
Requisitos y bueno saber
Dependencias
Odoo 19.0 Enterprise con el núcleo
MI ERP Facturación Digital Venezuela
(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 un contrato vigente con Procert ITFB, C.A. y credenciales (email y clave) del portal SIGECE, con su RIF emisor dado de alta. Los ambientes de prueba QA/QC de la imprenta permiten validar el flujo antes de pasar a producción.
GRUPO MI ERP SAS — José Luis Vizcaya López