Export CSV pour les commandes¶

Ce plugin permet l'export flexible des commandes Shopware 6 en fichier CSV – complètement ou filtré par période, statut, méthode de paiement et bien d'autres critères. Grâce à des profils individuels, vous pouvez définir les champs librement et adapter les exports à vos besoins spécifiques.

❓ FAQ¶

🔧 Installation¶

• Prérequis (Plugin CNK Foundation)
• Installation via Store ou ZIP
• Activation & Visibilité dans le Backend

🕒 Envoi automatique (Calendrier)¶

L'export basé sur le temps (Automation) est exécuté via le Worker en arrière-plan de Shopware – exactement comme toutes les autres tâches planifiées dans Shopware. Sur un shop correctement exploité, l'export s'exécute donc entièrement automatiquement, sans intervention manuelle.

*/5 * * * * /usr/bin/php /chemin/vers/shop/bin/console scheduled-task:run-single cnk_order_csv_export.task

🧩 Gérer les profils¶

Les profils d'export définissent quelles données se trouvent dans le fichier CSV et dans quel ordre elles apparaissent. Les profils se trouvent dans la zone d'administration Shopware sous Commandes > Export CSV > Profils.

Dans un profil, vous pouvez déterminer précisément quels champs doivent être inclus dans le fichier CSV exporté. Via le bouton « Ajouter un champ », vous pouvez sélectionner et organiser individuellement les champs de commande, de client, de produit et d'adresse. L'ordre des champs dans le profil correspond à l'ordre des colonnes dans le fichier CSV.

🗂️ Formats d'export & Modèles ERP¶

En plus du format standard CSV, vous pouvez également exporter vos profils d'export en Excel (XLSX), JSON ou XML.

Le format d'export est défini par profil dans l'onglet Configuration via le champ « Format de fichier » et est appliqué côté serveur à tous les chemins d'export (manuel, export rapide, calendrier, Flow Builder et CLI). Si l'In-App Purchase n'est pas actif, l'export revient automatiquement à CSV.

Activer un format Pro¶

1. Ouvrez un profil sous Commandes > Export CSV > Profils et allez à l'onglet Configuration.
2. Sélectionnez un format Pro (XLSX, JSON ou XML) sous Format de fichier. Si l'achat n'est pas encore actif, un message s'affiche avec le bouton « Activer ».
3. Après l'achat, le format est immédiatement disponible et est pris en compte lors de l'enregistrement.

Appliquer des modèles ERP¶

Les modèles ERP pré-remplissent en un clic la sélection des champs appropriés ainsi que les paramètres de séparateur, de nombre, de date et d'encodage pour le système cible:

Pour appliquer un modèle:

1. Assurez-vous que l'In-App Purchase « Formats Pro & Modèles ERP » est actif.
2. Sélectionnez le système souhaité sous Modèle ERP dans le profil et cliquez sur « Appliquer le modèle ».
3. La sélection des champs et les paramètres de format sont pris en charge. Le Format de fichier choisi est conservé – vous pouvez donc, par exemple, exporter une sélection de champs DATEV également en XLSX.

💡 L'application d'un modèle remplace la sélection des champs actuelle du profil. Adaptez les champs ensuite si nécessaire et enregistrez le profil.

🔄 Export incrémentiel / Delta¶

Avec l'export delta, à chaque exécution uniquement les commandes créées ou modifiées depuis le dernier export réussi sont exportées. Cela maintient une gestion des stocks ou une comptabilité synchronisée sans doublons et – particulièrement pour de grandes quantités de commandes – économise du temps et du volume de données.

• Activable par profil via le commutateur « Export Delta/Incrémentiel » dans l'onglet Configuration.
• Considère les commandes sur la base de la date de création ou de modification (createdAt/updatedAt), de sorte que même les commandes modifiées ultérieurement sont réexportées.
• Le Delta-Stand (Wasserzeichen) n'est mis à jour que après un export réussi – si une exécution échoue, aucune commande n'est perdue.
• Fonctionne via tous les chemins d'export: Calendrier, Flow Builder et CLI (Profil Config).

Configurer l'export Delta¶

1. Ouvrez un profil et allez à l'onglet Configuration.
2. Activez le commutateur « Export Delta/Incrémentiel ». Si l'achat n'est pas encore actif, un message s'affiche avec le bouton « Activer ».
3. Enregistrez le profil. À partir de l'exécution suivante, seules les commandes nouvelles ou modifiées seront exportées.

Réinitialiser le Delta-Stand¶

Si vous souhaitez réexporter toutes les commandes (par ex. pour un abonnement initial complet), réinitialisez le Wasserzeichen:

1. Ouvrez le profil dans l'onglet Configuration.
2. Cliquez sur « Réinitialiser » dans le message Delta et enregistrez le profil.
3. L'exécution suivante exporte à nouveau toutes les commandes correspondantes et définit ensuite un nouveau Wasserzeichen.

💡 L'export Delta utilise l'heure de début de l'export comme Wasserzeichen. De cette façon, au pire, quelques commandes sont exportées deux fois plutôt que d'être ignorées – idéal pour les importations idempotentes (Upserts) dans la gestion des stocks.

Variables¶

💡 Les noms de champs doivent être acceptés exactement comme indiqué dans la colonne de gauche.

L'aperçu suivant montre toutes les variables disponibles qui peuvent être utilisées dans un profil d'export. Celles-ci déterminent quelles données apparaissent dans le fichier CSV – par exemple les données de commande générales, les informations client, les champs d'adresse ou les détails des produits. Les noms de champs dans la colonne de gauche sont configurés dans le profil, la colonne de droite décrit le contenu.

🧾 Données générales de commande¶

📦 Lignes de commande¶

👤 Données client¶

🚚 Adresse d'expédition¶

🧾 Adresse de facturation¶

🛒 Données produit¶

🧬 Détails de position (Payload)¶

Données de snapshot stockées au moment de l'achat sur la ligne de commande.

📄 Documents¶

Champs issus de documents générés (Facture, Bon de livraison et – si le plugin Pickware est installé – Liste de sélection Pickware / Reçu PDV). Les valeurs ne sont remplies qu'une fois le document respectif créé pour la commande.

Facture¶

Bon de livraison¶

Pickware ERP-Picklist¶

Pickware Reçu PDV¶

⚡ Export rapide via l'aperçu des commandes¶

• Export direct des commandes sélectionnées
• Export direct des commandes filtrées

• Sélection d'un profil dans la liste déroulante

🔁 Tâches (Automatisation)¶

• Explication: Scheduled Task / Cronjob
• Options configurables:
  • Intervalle de temps ou jours de la semaine fixes + heure
  • Destination FTP / E-mail
  • Choix du profil (y compris format, modèle ERP et export delta du profil choisi)

📊 Activité & Protocollisation¶

• Historique d'export & Statut (Succès/Erreur)
• Fichier CSV-Log: Destinataire, Chemin FTP, Timestamp

• Les journaux se trouvent sous Commandes > Export CSV > Activité

• Le résultat ressemble à ceci

🖥️ Export via ligne de commande (CLI)¶

Export rapide des activités en cours¶

L'export de grandes quantités de données – même plus de 10 000 commandes – est possible. Une barre de progression intégrée affiche la progression de l'export.

Pour ne pas attendre la queue, vous pouvez déclencher l'export manuellement – par ex. pour un téléchargement CSV immédiat après la création d'un export:

#[AsCommand(
    name: 'cnk:csv-order-log:consume',
    description: 'Export all the activities in progress',
)]

L'export peut ensuite être démarré directement via la console:

bin/console cnk:csv-order-log:consume

Cette commande démarre tous les exports en cours directement via la console.

Export avec profil Shopware¶

bin/console cnk:csv-orders:export --fromDate 2023-05-15 --toDate 2025-02-01 --exportType sw_profile --mode order --profileName "Default orders" --limit 500

Export avec profil personnalisé¶

bin/console cnk:csv-orders:export --fromDate 2023-05-15 --toDate 2025-02-01 --exportType config --mode line_items --profileName "WAWI" --limit 500

• fromDate: Commandes à partir de, format Y-m-d
• toDate: Commandes jusqu'à, format Y-m-d
• exportType: Choix entre sw_profile et config
• mode: Choix entre order et line_items
• profileName: Profil standard ou profil créé par l'utilisateur
• limit: Limite des commandes à exporter (Valeur standard: 100)

📬 Support¶

Pour toute question, suggestion d'amélioration ou personnalisation, veuillez nous contacter par e-mail à support@cnk-plugins.de.