DF ERP Bridge — Exportación ERP planificada (Sage 100, EBP, Cegid, Codial)

DF ERP Bridge exporta automáticamente tus pedidos, clientes y stock de PrestaShop a tu software de gestión — Sage 100, EBP, Cegid, Codial — o a un formato genérico CSV, XML o JSON. Los archivos se generan con la cadencia que definas y se entregan automáticamente por FTP/FTPS o por e-mail, bajo el control de un cron. Esta guía cubre la instalación, la creación de perfiles, los formatos, los transportes, la planificación y la seguridad.

Instalación

1. En el back office, abre Módulos > Administrador de módulos, haz clic en Subir un módulo y suelta el archivo dferpbridge.zip.
2. Una vez instalado, haz clic en Configurar.
3. En la primera instalación se genera automáticamente un token de cron y la retención de registros se fija en 30 días. Ambos se pueden cambiar en la sección Ajustes al final de la página de configuración.

Crear un perfil de exportación

Un perfil describe una exportación: qué datos, en qué formato, hacia qué destino y con qué frecuencia. Puedes crear tantos perfiles como necesites. Haz clic en Añadir un perfil y rellena los campos.

Campos principales

• Nombre del perfil — una etiqueta que te ayude a identificarlo (p. ej. «Pedidos a Sage — diario»).
• Datos a exportar — Pedidos, Clientes o Stock.
• Formato ERP — Sage 100, EBP, Cegid, Codial, o un formato genérico CSV / XML / JSON.
• Transporte — Subida FTP o archivo adjunto por e-mail.
• Frecuencia — Horaria, Diaria o Semanal. Se evalúa en cada llamada del cron.
• Filtro de estados del pedido — (solo pedidos) selección múltiple; déjalo vacío para exportar todos los estados.
• Exportación incremental — solo exporta los registros creados desde la última ejecución.
• Activo — un perfil inactivo es ignorado por el cron pero puede ejecutarse manualmente.

Los formatos de exportación

Los cuatro presets ERP se producen en codificación Windows-1252, con separador punto y coma, saltos de línea CRLF y decimales con coma — la convención que esperan las herramientas de importación francesas. Los formatos genéricos se generan en UTF-8.

Sage 100

Archivo .txt de dos niveles: filas de cabecera «E» seguidas de sus filas de detalle «L», en una estructura compatible con la importación de documentos de Sage 100 Gestion Commerciale. Los gastos de envío se añaden en una línea dedicada «PORT». El orden de las columnas se puede reasignar en el asistente «formato de importación configurable» de Sage.

EBP

Archivo .csv plano con fila de cabeceras, una fila por línea de pedido (los campos de cabecera se repiten). Adecuado para la importación configurable de EBP Gestion Commerciale.

Cegid

Documento .xml estructurado en DOCUMENTS / DOCUMENT con un bloque ENTETE y un bloque LIGNES, para la integración de documentos al estilo Cegid Business / XRP Flex.

Codial

Archivo .csv plano con cabeceras, una fila por línea de pedido, pensado para el módulo de importación configurable de Codial.

Genéricos CSV / XML / JSON

Para cualquier otra herramienta (Odoo, Dolibarr, un ERP propio, una hoja de cálculo), estos formatos exportan todos los campos en UTF-8. El CSV genérico incluye un BOM para abrirlo correctamente en Excel; el XML anida las líneas bajo cada pedido; el JSON encapsula los registros en un envoltorio con entidad, fecha y número.

Transportes

FTP / FTPS

Indica el host, el puerto (21 por defecto), el usuario, la contraseña y la ruta remota (p. ej. /exports/prestashop). El modo pasivo y el SSL explícito (FTPS) se admiten mediante interruptores dedicados.

E-mail

El archivo se envía como adjunto a la dirección indicada en E-mail destinatario. Las plantillas de e-mail se ofrecen en francés e inglés.

Planificación por cron

El panel Ejecución planificada (cron) muestra la URL protegida que hay que llamar. Añádela a tu crontab o a un servicio de cron. En cada llamada, solo se ejecutan los perfiles cuya frecuencia está vencida (con una tolerancia de 5 minutos).

*/15 * * * * curl -s "https://tu-tienda.tld/module/dferpbridge/cron?token=TU_TOKEN" > /dev/null 2>&1

Parámetros opcionales de la URL:

• id_profile=N — ejecuta solo un perfil.
• force=1 — omite la comprobación de frecuencia y ejecuta de todos modos.

Ejecución manual

Cada perfil dispone de un botón Ejecutar ahora bajo la lista, que lanza la exportación de inmediato ignorando la frecuencia — útil para probar un perfil tras configurarlo.

Exportación incremental y filtros

En modo incremental, los pedidos y los clientes exportados son únicamente los creados después de la fecha de la última ejecución correcta, lo que evita duplicados en tu ERP. El stock siempre se exporta como instantánea completa, sea cual sea este ajuste.

Para los pedidos, el filtro de estados limita la exportación a los estados seleccionados (por ejemplo «Pago aceptado» y «Enviado»). Cada pedido incluye sus líneas de detalle, el IVA por línea, los gastos de envío y la dirección de facturación completa (SIRET, IVA intracomunitario).

Registro de exportaciones y retención

Las últimas 20 exportaciones aparecen en el back office con su estado (éxito, vacío, error), el número de registros, el archivo generado y un mensaje opcional. Los registros más antiguos que el periodo de retención configurado (30 días por defecto) se purgan automáticamente en cada ejecución del cron.

Seguridad

• La URL de cron está protegida por un token comparado en tiempo constante; una llamada sin token válido devuelve un error 403.
• La contraseña FTP se cifra en reposo y solo se descifra en el momento de la conexión.
• Puedes regenerar el token de cron desde Ajustes; la URL antigua deja entonces de funcionar.

Resolución de problemas

«Invalid token» al llamar al cron

Comprueba que el token de la URL coincide exactamente con el que se muestra en el panel de cron. Si se ha regenerado, actualiza tu crontab.

La exportación FTP falla

Asegúrate de que la extensión PHP FTP está disponible en el servidor, de que el host y el usuario son correctos, y de que la ruta remota existe. Prueba a activar o desactivar el modo pasivo según tu servidor.

El perfil se ejecuta pero no se produce ningún archivo

El estado «vacío» significa que ningún registro coincidía con los filtros (por ejemplo, ningún pedido nuevo desde la última ejecución en modo incremental, o un filtro de estados demasiado restrictivo).

Los formatos XML dan error

Los presets Cegid y XML genérico requieren la extensión PHP XMLWriter, estándar en la mayoría de los alojamientos PrestaShop.

Compatibilidad

• PrestaShop 8.0, 8.1, 8.2 y 9.x
• PHP 7.4 a 8.3
• Multitienda
• Extensión PHP FTP requerida para el transporte FTP; XMLWriter requerido para los formatos XML