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
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 | 29192 |
| Technical Name |
l10n_ve_imprenta_digital_procert |
| 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