Idoo CFDI — Timbrado CFDI 4.0 (México)

Cómo funciona

Este módulo no construye ni firma XML localmente y no maneja certificados CSD en disco. Toda la construcción del comprobante, la firma con el CSD y el timbrado ante el PAC se delegan por completo al servicio idoo.dev vía POST /v1/facturas/timbrar_arreglo: el módulo arma un JSON a partir de la factura de Dolibarr, lo envía, y guarda lo que la API regresa (UUID, XML, PDF).

El alta del CSD del emisor también se hace desde el módulo (Módulos > Idoo CFDI > Configurar CSD del emisor), pero el .cer/.key nunca se persisten en Dolibarr: se leen del upload temporal de PHP, se codifican en base64, se envían por HTTPS a POST /v1/emisores/subir_csd, y se descartan de memoria inmediatamente.

Instalación

1. Copiar la carpeta idoocfdi/ a htdocs/ (o a htdocs/custom/ si se instala como módulo externo).
2. Activar el módulo desde Inicio > Configuración > Módulos/Aplicaciones.
3. Ir a Módulos > Idoo CFDI > Configuración:
   • Elegir ambiente (sandbox o producción) y capturar la API Key correspondiente (se obtiene en el portal de idoo.dev, /portal/apikeys).
   • Capturar RFC, razón social, régimen fiscal y código postal de expedición del emisor.
4. Ir a Configurar CSD del emisor y subir el .cer/.key/contraseña del CSD.
5. En cada tercero que vaya a recibir CFDI, llenar sus datos fiscales — el módulo reutiliza campos nativos de Dolibarr siempre que existen, en vez de duplicarlos:
   • RFC: en el campo nativo "ID Prof. 1" de la ficha del tercero (el módulo lo re-etiqueta como "RFC" para terceros mexicanos al activarse).
   • Código postal: se usa el campo de dirección del tercero (CP) como domicilio fiscal. Si el domicilio fiscal del cliente es distinto a su dirección en Dolibarr, hay que ajustar el CP antes de timbrar.
   • Régimen fiscal: se usa el campo nativo "Tipo de entidad comercial" (fk_forme_juridique) del tercero — Dolibarr ya trae precargados los 19 regímenes fiscales del SAT para México en ese catálogo (Configuración > Diccionarios > Formas jurídicas), no hay que capturarlo dos veces.
   • Uso de CFDI por defecto: en la pestaña de campos adicionales del tercero (este sí es propio del módulo, no tiene equivalente nativo en Dolibarr).
6. En cada producto, llenar Clave Prod/Serv SAT y Clave Unidad SAT (si se deja vacío, se usa el default configurado en el módulo, con el riesgo de que el SAT rechace el CFDI si ese default no aplica al producto real).
7. Otorgar a los usuarios que van a timbrar/cancelar los permisos correspondientes (Inicio > Usuarios y grupos > (usuario) > Permisos) — por defecto solo el permiso de lectura/consulta viene activado; timbrar y cancelar son permisos fiscalmente sensibles que se activan explícitamente.

Alcance de esta versión (v1)

Solo factura tipo "Factura" normal (Ingreso) de Dolibarr, moneda MXN, sin descuentos por línea, con IVA trasladado (16%/8%/0%) por línea. Acciones soportadas: timbrar, consultar estatus, regenerar PDF, cancelar.

Fuera de alcance (roadmap)

• Notas de crédito / egreso relacionadas (tipo E)
• Complemento de pago (REP / PPD)
• Factura global (punto de venta)
• Comercio exterior / carta porte / addendas
• Multi-emisor (varios RFC en la misma instalación)
• Catálogo completo de ClaveProdServ/ClaveUnidad con buscador (por ahora son campos de texto libre por producto)
• IEPS y retenciones de ISR/IVA
• Descuentos por línea
• Moneda extranjera con tipo de cambio
• API REST propia del módulo (hoy solo hay botones en la interfaz)

Seguridad

• La API Key vive únicamente en llx_const (constantes del módulo), nunca en extrafields ni en código.
• El CSD nunca toca el disco ni la base de datos de Dolibarr.
• Cada llamada a la API queda registrada en llx_idoocfdi_facturas_log para poder depurar rechazos del SAT sin repetir la llamada, pero esos registros nunca incluyen el CSD, la contraseña del CSD, la API Key, ni los binarios de XML/PDF (esos ya se guardan como documento adjunto de la factura).

Soporte

Este módulo es parte de los servicios de Idoo.