Workflow d'Export

Maitrisez l'export de vos produits vers differentes plateformes et destinations : formats multiples, destinations cloud et planification automatique.

Vue d'Ensemble

Products Manager permet d'exporter vos produits vers :

• Fichiers locaux : CSV, Excel, JSON
• Stockage cloud : MinIO, Amazon S3
• Plateformes e-commerce : Shopify, WooCommerce, PrestaShop, etc.

Formats d'Export

Formats Disponibles

Caracteristiques par Format

CSV

ean;title;price;stock;brand;category
3760001234567;T-shirt bleu;29.99;150;MaMarque;Vetements/Hommes
3760001234568;Jean slim;59.99;80;MaMarque;Vetements/Hommes

Avantages :

• Format universel
• Leger et rapide
• Compatible avec tous les outils

Options :

• Separateur : virgule, point-virgule, tabulation
• Encodage : UTF-8, ISO-8859-1
• Guillemets : automatiques ou forces

Excel

Avantages :

• Mise en forme preservee
• Formules et filtres Excel
• Ideal pour analyse

Options :

• Nom de la feuille
• Entetes en gras
• Largeur des colonnes automatique

JSON

{
  "products": [
    {
      "ean": "3760001234567",
      "title": "T-shirt bleu",
      "price": 29.99,
      "stock": 150,
      "brand": "MaMarque",
      "category": "Vetements/Hommes"
    }
  ]
}

Avantages :

• Structure hierarchique
• Integration API facile
• Types de donnees preserves

Creer un Export

Etape 1 : Acceder aux Exports

1. Cliquez sur Exports dans le menu
2. Cliquez sur + Nouvel export

Etape 2 : Selectionner les Produits

Plusieurs methodes de selection :

Filtres Disponibles

• Categorie : Selection dans l'arborescence
• Fournisseur : Un ou plusieurs fournisseurs
• Marque : Texte libre ou liste
• Statut : Actif, Inactif, Archive
• Stock : En stock, Rupture
• Date creation/modification : Periode
• Tags : Selection multiple
• has_asin : Avec/sans ASIN Amazon
• has_price : Avec/sans prix defini

Etape 3 : Choisir le Format

Selectionnez le format de sortie :

• CSV : Export standard
• Excel : Fichier .xlsx
• JSON : Format structure

Etape 4 : Configurer le Mapping

Selectionnez les colonnes a exporter :

Champs Standards

Colonnes Personnalisees

• Selectionnez les attributs personnalises
• Renommez les colonnes si necessaire
• Definissez l'ordre des colonnes

Etape 5 : Lancer l'Export

1. Verifiez le resume :
   • Nombre de produits
   • Format selectionne
   • Colonnes configurees
2. Cliquez sur Generer l'export
3. Telechargez le fichier ou envoyez vers une destination

Destinations d'Export

Telechargement Direct

Par defaut, le fichier est telecharge dans votre navigateur.

MinIO

MinIO est le stockage objet integre a Products Manager.

Configuration MinIO

1. Dans l'export, selectionnez Destination : MinIO
2. Configurez :

Pattern de Nommage

Utilisez des variables dans le nom de fichier :

Exemple :

Nom: export-{date}-{count}.{format}
Resultat: export-2025-12-06-1250.csv

Amazon S3

Pour exporter vers Amazon S3 :

1. Selectionnez Destination : S3
2. Configurez :

Exports Planifies

Configurer un Export Planifie

1. Apres avoir configure un export
2. Activez Planifier cet export
3. Configurez la planification :

Options de Frequence

Configuration Detaillee

Destination pour les Planifies

Les exports planifies necessitent une destination automatique :

• MinIO : Stockage interne
• S3 : Amazon S3
• Email : Envoi en piece jointe (fichiers < 10 MB)
• FTP/SFTP : Upload vers un serveur

Notifications

Configurez les alertes :

• [ ] Export reussi
• [ ] Export avec avertissements
• [ ] Export echoue

Templates d'Export

Creer un Template

1. Configurez un export complet
2. Cliquez sur Sauvegarder comme template
3. Nommez le template
4. Reutilisez-le pour les prochains exports

Templates Predefinies

Products Manager fournit des templates optimises :

Utiliser un Template

1. Lors d'un nouvel export
2. Cliquez sur Charger un template
3. Selectionnez le template
4. Ajustez si necessaire

Export vers Plateformes E-commerce

Plateformes Supportees

Configuration Shopify

Options Shopify :

• [ ] Inclure les variantes
• [ ] Exporter les images
• [ ] Inclure le SEO (meta title, description)

Configuration WooCommerce

Options WooCommerce :

• [ ] Format XML (plugin compatible)
• [ ] Inclure les attributs
• [ ] Exporter les images base64

Configuration PrestaShop

Options PrestaShop :

• [ ] Multi-langue (FR, EN, ES...)
• [ ] Prix HT / TTC
• [ ] Inclure les declinaisons

Gestion des Images

Options d'Export des Images

Optimisation

Pour les exports avec images :

• Redimensionnement : Max 2000x2000 px
• Format : JPEG (photos), PNG (logos)
• Qualite : 80% (bon compromis)

Historique des Exports

Consulter l'Historique

1. Exports dans le menu
2. Onglet Historique
3. Liste des exports avec :
   • Date et heure
   • Format
   • Nombre de produits
   • Destination
   • Statut

Actions sur l'Historique

Pour chaque export :

• Telecharger : Recuperer le fichier (si encore disponible)
• Re-executer : Lancer le meme export avec les donnees actuelles
• Voir les details : Logs et statistiques

Retention des Fichiers

Bonnes Pratiques

Avant l'Export

1. Verifiez les donnees : Titres, descriptions completes
2. Validez les images : URLs accessibles
3. Testez sur un echantillon : 10-50 produits d'abord

Pendant l'Export

1. Planifiez en heures creuses : Moins de charge serveur
2. Evitez les exports simultanes : Un a la fois
3. Surveillez la progression : Verifiez les erreurs

Apres l'Export

1. Verifiez le fichier : Ouvrez-le avant import cible
2. Testez l'import : Sur la plateforme cible
3. Conservez l'historique : Pour reference

Troubleshooting

Certains produits ne sont pas exportes

Causes possibles :

• Produits inactifs ou archives
• Champs requis manquants
• Filtres trop restrictifs

Solutions :

1. Verifiez le statut des produits
2. Completez les champs obligatoires
3. Ajustez les filtres de selection

Le fichier est rejete par la plateforme

Causes possibles :

• Format incorrect
• Encodage incompatible
• Champs manquants ou mal formates

Solutions :

1. Utilisez le template officiel de la plateforme
2. Verifiez l'encodage UTF-8
3. Consultez les erreurs de la plateforme

Les images ne s'affichent pas

Causes possibles :

• URLs non accessibles
• Images trop volumineuses
• Format non supporte

Solutions :

1. Verifiez que les URLs sont publiques
2. Optimisez les images (moins de 2 MB)
3. Utilisez JPEG ou PNG

Export vers MinIO/S3 echoue

Causes possibles :

• Credentials incorrects
• Bucket non existant
• Permissions insuffisantes

Solutions :

1. Verifiez les credentials
2. Creez le bucket si necessaire
3. Verifiez les permissions IAM

Limites et Performance

Limites par Export

Performance Estimee

API d'Export

Lancer un Export via API

POST /api/v1/exports
Content-Type: application/json
Authorization: Bearer <token>

{
  "format": "csv",
  "filters": {
    "supplier_id": "uuid",
    "status": "active"
  },
  "columns": ["ean", "title", "price", "stock"],
  "destination": {
    "type": "minio",
    "bucket": "exports",
    "path": "daily/"
  }
}

Consulter le Statut

GET /api/v1/exports/{export_id}
Authorization: Bearer <token>

Telecharger le Fichier

GET /api/v1/exports/{export_id}/download
Authorization: Bearer <token>

Prochaines Etapes

• Gestion des Produits - Gerer votre catalogue
• Workflow d'Import - Importer vos produits
• API Endpoints - Automatiser via API