¡Hola a toda la comunidad de Dolibarr!
Presentamos Idoo CFDI, un nuevo módulo diseñado específicamente para resolver la facturación electrónica en México (CFDI 4.0) de forma nativa, segura y sin complicaciones técnicas dentro de Dolibarr.
Este módulo permite timbrar facturas y emitir Complementos de Pago (REP) directamente desde las fichas nativas del ERP, delegando toda la complejidad criptográfica (armado de XML, sellado y timbrado ante el PAC) a la API de idoo.dev.
A continuación, detallamos sus características, ventajas de seguridad y cómo empezar a utilizarlo.
🚀 Características Principales
- Timbrado CFDI 4.0 Directo: Genera facturas (Ingreso) con sus archivos XML y PDF sin salir de la ficha de la factura en Dolibarr.
- Complementos de Pago (REP) Nativos: Emite el REP directamente desde la ficha del pago (
compta/paiement).
- Agrupación de facturas: Si un pago cubre varias facturas, el módulo genera un solo REP para todas.
- Envío de Correo Integrado: Envía las facturas y los REP por correo con XML y PDF adjuntos automáticamente.
- Reutilización de Datos Nativos: No duplicamos campos; el módulo utiliza los campos nativos de Dolibarr para la facturación.
🔒 Arquitectura y Seguridad (Cero manejo de CSD local)
La seguridad de los Certificados de Sello Digital (CSD) de tu empresa es nuestra prioridad.
- Sin almacenamiento local: El módulo no construye ni firma XML localmente.
- Tránsito seguro en memoria: El certificado (
.cer), la llave privada (.key) y la contraseña se envían a la API en memoria y se descartan inmediatamente sin tocar el disco duro ni la base de datos de Dolibarr.
- Autenticación por API Key: Toda la comunicación se realiza mediante una única API Key segura.
- Detección de entorno: El ambiente (sandbox o producción) se calcula automáticamente según el prefijo de tu API Key.
- Trazabilidad sin riesgo: Los logs de las llamadas a la API se guardan para depurar rechazos del SAT, pero jamás incluyen datos sensibles del CSD.
⚙️ Instalación y Configuración Paso a Paso
Instalación del Módulo
- Descarga y copia la carpeta
idoocfdi/ dentro del directorio htdocs/ de tu instalación.
- Ve a Inicio > Configuración > Módulos/Aplicaciones y activa el módulo Idoo CFDI.
- Otorga los permisos de timbrado y cancelación a los usuarios correspondientes en Inicio > Usuarios y grupos > Permisos.
Configuración del Emisor
- Ve a Módulos > Idoo CFDI > Configuración.
- Ingresa tu API Key obtenida en el portal de idoo.dev.
- Captura los datos fiscales del emisor: RFC, Razón Social, Régimen Fiscal y Código Postal de expedición.
- Entra a Configurar CSD del emisor y sube temporalmente tus archivos
.cer, .key y contraseña para registrarlos en la API.
Configuración de Terceros (Clientes) y Productos
- RFC: Captúralo en el campo nativo ID Prof. 1 de la ficha del cliente.
- Código Postal: Se toma de la dirección principal del tercero en Dolibarr.
- Régimen Fiscal: Se selecciona desde el campo nativo Tipo de entidad comercial.
- Uso de CFDI: Se configura en la nueva pestaña de campos adicionales que agrega el módulo.
- Productos: Asigna la Clave Prod/Serv SAT y la Clave Unidad SAT en la ficha de cada producto o servicio.
💡 Emisión de Complementos de Pago (REP)
Si timbras una factura con Método de Pago PPD (Pago en Parcialidades o Diferido), el SAT exige un CFDI tipo P. El proceso es muy sencillo:
- Registra el pago en Dolibarr de forma habitual.
- Abre la ficha de ese pago; si hay facturas PPD con saldo pendiente, verás el botón "Emitir Complemento de Pago (REP)".
- Al timbrarlo, aparecerá el botón "Enviar por correo", el cual adjunta automáticamente el XML y PDF.
Nota técnica sobre el REP (v1): Esta versión soporta una sola tasa de IVA por factura cubierta, únicamente pagos en MXN, y no incluye retenciones en el complemento. En caso de cancelar un REP por error, la sustitución debe realizarse de forma manual.
📧 Plantillas de Correo y Variables
El módulo registra su propio tipo de plantilla de correo (idoocfdi_pago_send), permitiendo personalizar tu mensaje (logo, marca, texto) desde Configuración > Plantillas de correo. Puedes utilizar las variables genéricas de Dolibarr, además de las siguientes variables exclusivas del módulo:
| Variable de sustitución | Contenido dinámico |
| :--- | :--- |
| __IDOOCFDI_FOLIO__ | Folio interno del Complemento de Pago |
| __IDOOCFDI_UUID__ | UUID fiscal del REP timbrado |
| __IDOOCFDI_MONTO__ | Monto total del pago (monto_total_pagos) |
| __IDOOCFDI_FECHA_PAGO__ | Fecha en la que se realizó el pago |
| __IDOOCFDI_FACTURAS__ | Folio(s) de la(s) factura(s) cubiertas por el REP |
🗺️ Roadmap (Próximas actualizaciones)
Este módulo es una versión V1 enfocada en la estabilidad del flujo principal de ingresos. Nuestro alcance futuro incluye:
- Notas de crédito y egresos (Tipo E).
- Reemplazo automático de un REP cancelado (
TipoRelacion).
- Factura global (Punto de venta).
- Comercio exterior, Carta Porte y Addendas.
- Soporte multi-emisor (varios RFC en la misma instalación).
- Buscador interactivo para el catálogo de ClaveProdServ/ClaveUnidad.
- Manejo de IEPS, retenciones, descuentos por línea y moneda extranjera.
📥 Descargas y Soporte
Este módulo forma parte de los servicios de Idoo. Para ver la documentación completa de la API, revisar el contrato de datos, o para obtener tu API Key, visita idoo.dev.
Si tienes dudas sobre la instalación, reportes de bugs o sugerencias para el roadmap, ¡déjanos una respuesta en esta misma discusión! Estaremos leyendo y ayudando a la comunidad.
