PS PrestaShop PrestaShop Intermédiaire

DF ERP Bridge — Export ERP planifié (Sage 100, EBP, Cegid, Codial)

Installer et configurer l'export ERP planifié : profils, formats Sage 100 / EBP / Cegid / Codial, transports FTP et e-mail, cron.

Mis à jour Version du module 1.0.0

DF ERP Bridge exporte automatiquement vos commandes, clients et stock PrestaShop vers votre logiciel de gestion — Sage 100, EBP, Cegid, Codial — ou vers un format générique CSV, XML ou JSON. Les fichiers sont générés selon la cadence que vous définissez et livrés automatiquement par FTP/FTPS ou par e-mail, sous le contrôle d’un cron. Ce guide couvre l’installation, la création de profils, les formats, les transports, la planification et la sécurité.

Installation

  1. Dans le back-office, ouvrez Modules > Gestionnaire de modules, cliquez sur Installer un module et déposez le fichier dferpbridge.zip.
  2. Une fois installé, cliquez sur Configurer.
  3. À la première installation, un jeton de cron est généré automatiquement et la rétention des journaux est fixée à 30 jours. Ces réglages sont modifiables dans la section Réglages en bas de la page de configuration.

Le module est purement back-office : il n’ajoute rien au front de votre boutique. Il est compatible PrestaShop 8.0 à 9.x et multiboutique.

Créer un profil d’export

Un profil décrit un export : quelles données, dans quel format, vers quelle destination et à quelle fréquence. Vous pouvez créer autant de profils que nécessaire. Cliquez sur Ajouter un profil et renseignez les champs.

Champs principaux

  • Nom du profil — un libellé qui vous aide à l’identifier (ex. « Commandes vers Sage — quotidien »).
  • Données à exporter — Commandes, Clients ou Stock.
  • Format ERP — Sage 100, EBP, Cegid, Codial, ou un format générique CSV / XML / JSON.
  • Transport — Dépôt FTP ou pièce jointe e-mail.
  • Fréquence — Horaire, Quotidienne ou Hebdomadaire. Évaluée à chaque appel du cron.
  • Filtre de statuts de commande — (commandes uniquement) sélection multiple ; laissez vide pour exporter tous les statuts.
  • Export incrémental — n’exporte que les enregistrements créés depuis le dernier passage.
  • Actif — un profil inactif est ignoré par le cron mais reste exécutable manuellement.

Les formats d’export

Les quatre presets ERP sont produits en encodage Windows-1252, avec un séparateur point-virgule, des retours à la ligne CRLF et des décimales à la virgule — la convention attendue par les outils d’import français. Les formats génériques sortent en UTF-8.

Sage 100

Fichier .txt à deux niveaux : des lignes d’entête « E » suivies de leurs lignes de détail « L », dans une structure compatible avec l’import de documents de Sage 100 Gestion Commerciale. Les frais de port sont ajoutés en ligne dédiée « PORT ». L’ordre des colonnes est remappable dans l’assistant « Format d’import paramétrable » de Sage.

EBP

CSV plat .csv avec ligne d’en-têtes, une ligne par ligne de commande (les champs d’entête sont répétés). Adapté à l’import paramétrable d’EBP Gestion Commerciale.

Cegid

Document XML .xml structuré en DOCUMENTS / DOCUMENT avec un bloc ENTETE et un bloc LIGNES, pour l’intégration de documents façon Cegid Business / XRP Flex.

Codial

CSV plat .csv avec en-têtes, une ligne par ligne de commande, pensé pour le module d’import configurable de Codial.

Génériques CSV / XML / JSON

Pour tout autre outil (Odoo, Dolibarr, ERP maison, tableur), ces formats exportent l’intégralité des champs en UTF-8. Le CSV générique inclut un BOM pour une ouverture propre dans Excel ; le XML imbrique les lignes sous chaque commande ; le JSON encapsule les enregistrements dans une enveloppe avec entité, date et nombre.

Transports

FTP / FTPS

Renseignez l’hôte, le port (21 par défaut), l’utilisateur, le mot de passe et le chemin distant (ex. /exports/prestashop). Le mode passif et le SSL explicite (FTPS) sont pris en charge par des interrupteurs dédiés.

Le mot de passe FTP est chiffré au repos en base avec la clé de chiffrement de votre boutique. Lors de la modification d’un profil, laissez le champ mot de passe vide pour conserver la valeur existante.

E-mail

Le fichier est envoyé en pièce jointe à l’adresse indiquée dans E-mail destinataire. Les modèles d’e-mail sont fournis en français et en anglais.

Planification par cron

Le panneau Exécution planifiée (cron) affiche l’URL sécurisée à appeler. Ajoutez-la à votre crontab ou à un service de cron. À chaque appel, seuls les profils dont la fréquence est échue s’exécutent (avec une tolérance de 5 minutes).

*/15 * * * * curl -s "https://votre-boutique.tld/module/dferpbridge/cron?token=VOTRE_TOKEN" > /dev/null 2>&1

Paramètres optionnels de l’URL :

  • id_profile=N — n’exécute qu’un seul profil.
  • force=1 — ignore le contrôle de fréquence et exécute quoi qu’il arrive.

Planifiez le cron au moins aussi souvent que la fréquence la plus élevée utilisée par vos profils. Un profil « horaire » a besoin d’un cron appelé au minimum toutes les heures.

Exécution manuelle

Chaque profil dispose d’un bouton Lancer maintenant sous la liste, qui déclenche l’export immédiatement en ignorant la fréquence — pratique pour tester un profil après configuration.

Export incrémental et filtres

En mode incrémental, les commandes et les clients exportés sont uniquement ceux créés après la date du dernier passage réussi, ce qui évite les doublons dans votre ERP. Le stock est toujours exporté en instantané complet, quel que soit ce réglage.

Pour les commandes, le filtre de statuts limite l’export aux états sélectionnés (par exemple « Paiement accepté » et « Expédié »). Chaque commande embarque ses lignes de détail, la TVA calculée par ligne, les frais de port et l’adresse de facturation complète (SIRET, TVA intracommunautaire).

Journal des exports et rétention

Les 20 derniers exports apparaissent en back-office avec leur statut (succès, vide, erreur), le nombre d’enregistrements, le fichier généré et un message éventuel. Les journaux plus anciens que la durée de rétention configurée (30 jours par défaut) sont purgés automatiquement à chaque passage du cron.

Sécurité

  • L’URL de cron est protégée par un jeton comparé en temps constant ; un appel sans jeton valide renvoie une erreur 403.
  • Le mot de passe FTP est chiffré au repos et n’est déchiffré qu’au moment de la connexion.
  • Vous pouvez régénérer le jeton de cron depuis les Réglages ; l’ancienne URL cesse alors de fonctionner.

Dépannage

« Invalid token » lors de l’appel du cron

Vérifiez que le jeton dans l’URL correspond exactement à celui affiché dans le panneau cron. S’il a été régénéré, mettez à jour votre crontab.

L’export FTP échoue

Assurez-vous que l’extension PHP FTP est disponible sur le serveur, que l’hôte et l’utilisateur sont corrects, et que le chemin distant existe. Essayez d’activer ou de désactiver le mode passif selon votre serveur.

Le profil s’exécute mais aucun fichier n’est produit

Le statut « vide » signifie qu’aucun enregistrement ne correspondait aux filtres (par exemple, aucune nouvelle commande depuis le dernier passage en mode incrémental, ou un filtre de statuts trop restrictif).

Les formats XML sont en erreur

Les presets Cegid et XML générique nécessitent l’extension PHP XMLWriter, standard sur la plupart des hébergements PrestaShop.

Compatibilité

  • PrestaShop 8.0, 8.1, 8.2 et 9.x
  • PHP 7.4 à 8.3
  • Multiboutique
  • Extension PHP FTP requise pour le transport FTP ; XMLWriter requis pour les formats XML
Cette page vous a-t-elle été utile ?

Toujours bloqué ? Contactez le support