EM Clearfacts

EMClearFacts — Envío automático de facturas a Clearfacts desde Dolibarr

El módulo EMClearFacts conecta su Dolibarr directamente con la plataforma contable Clearfacts a través de su API GraphQL oficial. Envíe sus facturas de clientes y proveedores a su contable con un clic o de forma automática, en formato XML UBL o PDF, con una pista de auditoría completa y permanente de cada envío.

Se acabó subir manualmente los PDF a Clearfacts: valide su factura en Dolibarr, EMClearFacts se encarga del resto.

🚀 Envío de facturas de clientes y proveedores

• Envío en un clic desde la ficha de cualquier factura validada
• Envío automático en la validación gracias a una cola inteligente
• Soporte para facturas de venta y facturas de compra, con activación independiente
• Gestión nativa de abonos (credit notes)
• Acción masiva «Añadir a la cola de Clearfacts» en las listas de facturas
• Botón Clearfacts y badge de estado directamente en la ficha de cada factura (visualización configurable)

📄 Formato inteligente: XML UBL o PDF

EMClearFacts detecta automáticamente el mejor formato disponible para cada factura:

• Si hay un archivo XML UBL adjunto a la factura (por ejemplo mediante el módulo EMPeppol u otro módulo de facturación electrónica), se envía en prioridad a Clearfacts — permitiendo la contabilización automática de líneas, IVA y totales
• En caso contrario, se envía automáticamente el PDF de la factura
• Comportamiento configurable: preferir siempre XML o enviar siempre PDF

🔐 Dos métodos de autenticación a elegir

• OAuth 2.0 (recomendado para uso multiusuario) — flujo Authorization Code mediante un relé automático, sin necesidad de copiar y pegar códigos
• Personal Access Token (PAT) de 80 caracteres — ideal para uso interno de un solo usuario, configuración en 30 segundos
• Cambie entre ambos métodos en cualquier momento sin perder el historial

🏢 Detección automática de la administración

Ya no necesita introducir manualmente el número de IVA de su expediente Clearfacts:

• EMClearFacts consulta la API de Clearfacts y lista automáticamente las administraciones a las que tiene acceso
• Selección por menú desplegable si hay varias administraciones, selección automática si solo hay una
• Muestra el nombre, número de empresa y detalles directamente desde la API

⚙️ Cola de envío inteligente

Entre la validación de una factura y su envío efectivo, un retraso configurable le deja el control:

• Retraso antes del envío automático (15 minutos por defecto) — cancele o modifique una factura justo después de validarla sin que se envíe
• Reintentos automáticos con backoff exponencial (1 min, 5 min, 15 min) en caso de error temporal
• Recuperación automática de elementos bloqueados (worker interrumpido, crash PHP) tras 15 minutos
• Botón «Procesar ahora» que ignora los plazos de reintento para forzar un envío inmediato tras corregir un problema
• Cancelación de un envío pendiente, reintento individual o masivo de facturas fallidas

📊 Historial permanente (pista de auditoría)

Cada envío queda registrado de forma permanente y nunca se purga. El historial es su pista de auditoría oficial:

• Fecha y hora exactas de cada intento
• UUID Clearfacts devuelto por la API para cada envío exitoso (enlace directo al documento en su cuenta Clearfacts)
• Formato transmitido (PDF o XML UBL), usuario que inició el envío
• Mensaje de error detallado en caso de fallo
• Página dedicada «Facturas enviadas» con filtros por estado, tipo, referencia, rango de fechas
• Pestaña Clearfacts en cada ficha de factura — historial para una factura dada
• Protección automática contra duplicados: una factura ya enviada con éxito nunca se envía dos veces por error

🧪 Sandbox y producción

• Conmutador de entorno entre Sandbox (sandbox.clearfacts.be) y Producción (app.clearfacts.be)
• Banner amarillo visible en todas las páginas del módulo en modo Sandbox para evitar confusiones
• Pruebe su configuración con facturas reales antes de pasar a producción

⚡ Fácil de instalar, potente de usar

• Sin dependencias externas — sin Composer, sin biblioteca de terceros que instalar, el módulo funciona inmediatamente tras extraerlo
• Modo Simple / Experto: interfaz depurada para empezar rápido, opciones avanzadas accesibles con un clic
• No intrusivo: solo hooks y triggers, sin modificaciones del core de Dolibarr
• Compatible con Multicompany: configuración independiente por entidad (token, administración, opciones de envío)
• Tarea programada Dolibarr integrada para el procesamiento automático de la cola (cada 5 minutos)
• Documentación completa para el usuario final en francés e inglés incluida en el módulo (instalación, configuración, uso, preguntas frecuentes)

🔧 Compatibilidad

• Dolibarr: 18.0+
• PHP: 7.4 — 8.3
• Compatible con o sin el módulo Multicompany
• Funciona junto con otros módulos de facturación electrónica como EMPeppol (envíe a Clearfacts y Peppol desde la misma factura)

📚 Más información

👉 Página del producto EMClearFacts

👉 Documentación completa — guía de instalación, configuración, preguntas frecuentes y casos de uso

🤝 Soporte y actualizaciones

Módulo mantenido activamente y actualizado regularmente. Soporte por correo electrónico con respuesta rápida.

• 📧 Soporte: support@e-dem.com
• 🌐 Sitio web: www.e-dem.com