Modèle export Excel

Lien isolé Accueil docs Formation
Technique & dev

Format et modèle d'export Excel pour produits et rapports.

Modèles des fichiers Excel (CSV) à exporter

L’application exporte les rapports en CSV (UTF-8 avec BOM), ouvrable directement dans Excel. Voici le détail des colonnes pour chaque type d’export.


1. Export des ventes

Fichier généré : ventes_YYYY-MM-DD_YYYY-MM-DD.csv
Où : Rapports → Ventes → Export Excel

Colonne Description Exemple
Référence Numéro de la vente V-2025-00042
Date Date et heure 02/02/2025 14:30
Caissier Nom du caissier Jean Dupont
Total Montant total (FC) 15 000
Paiement Mode de paiement Espèces
Produits Liste des produits (nom x quantité) Tomates (x2), Riz (x1)

Exemple de lignes :

Référence,Date,Caissier,Total,Paiement,Produits
V-2025-00042,02/02/2025 14:30,Jean Dupont,15000,Espèces,"Tomates fraîches (x2), Riz blanc (x1)"

2. Export rapport produits (ventes par produit)

Fichier généré : produits_YYYY-MM-DD_YYYY-MM-DD.csv
Où : Rapports → Produits → Export Excel

Colonne Description Exemple
Code Code article PROD-001
Nom Nom du produit Tomates fraîches
Quantité vendue Quantité vendue sur la période 45
Chiffre d'affaires CA total (FC) 67 500

Exemple de lignes :

Code,Nom,Quantité vendue,Chiffre d'affaires
PROD-001,Tomates fraîches,45,67500
PROD-002,Riz blanc 1 kg,120,300000

3. Export du stock

Fichier généré : stock_YYYY-MM-DD.csv
Où : Rapports → Stock → Export Excel

Colonne Description Exemple
Code Code article PROD-001
Nom Nom du produit Tomates fraîches
Catégorie Nom de la catégorie Fruits et Légumes
Stock Quantité en stock 50
Minimum Seuil d’alerte 10
Prix d'achat Prix d’achat unitaire (FC) 800
Prix de vente Prix de vente unitaire (FC) 1500
Valeur stock Stock × prix d’achat (FC) 40 000

Exemple de lignes :

Code,Nom,Catégorie,Stock,Minimum,Prix d'achat,Prix de vente,Valeur stock
PROD-001,Tomates fraîches,Fruits et Légumes,50,10,800,1500,40000
PROD-002,Riz blanc 1 kg,Épicerie sèche,200,20,1800,2500,360000

4. Export rapport de caisse

Fichier généré : rapport_caisse_YYYY-MM-DD_YYYY-MM-DD.csv
Où : Rapports → Caisse → Export Excel

Colonne Description Exemple
Date Date/heure ouverture 02/02/2025 08:00
Caissier Nom du caissier Jean Dupont
Solde ouverture Solde en début de session 50 000
Ventes Total des ventes 120 000
Mouvements entrée Entrées caisse 0
Mouvements sortie Sorties caisse 10 000
Solde attendu Solde calculé 160 000
Solde fermeture Solde saisi à la fermeture 160 000
Différence Écart (si fermée) 0
Statut Ouverte / Fermée Fermée

Exemple de lignes :

Date,Caissier,Solde ouverture,Ventes,Mouvements entrée,Mouvements sortie,Solde attendu,Solde fermeture,Différence,Statut
02/02/2025 08:00,Jean Dupont,50000,120000,0,10000,160000,160000,0,Fermée

5. Export catalogue produits (page Produits)

Fichier généré : catalogue_produits_YYYY-MM-DD.csv
Où : Produits → Exporter Excel

Colonne Description Exemple
Code Code article PROD-001
Nom Nom du produit Tomates fraîches
Catégorie Nom de la catégorie Fruits et Légumes
Prix Prix de vente (FC) 1500
Prix_achat Prix d'achat (FC) 800
Unité Unité de vente kg, pièce, etc.

Ce fichier peut être réimporté via Importer Excel (même format).


6. Modèle pour import de produits (page Produits → Importer Excel)

L’import catalogue accepte deux formats :

Format simple : Code, Nom
Format complet : Code, Nom, Catégorie, Prix, Prix_achat, Unité (ou sans Code : categorie, nom, prix, prix_achat, unite)

Colonne Alias accepté Description Exemple
code — Code article PROD-001
nom name, produit Nom du produit Tomates fraîches
categorie category Nom catégorie Fruits et Légumes
prix price Prix de vente 1500
prix_achat pua, purchase_price Prix d'achat 800
unite unit Unité de vente kg, paquet, pièce

Exemple format complet :

Code;Nom;Catégorie;Prix;Prix_achat;Unité
PROD-001;Tomates fraîches;Fruits et Légumes;1500;800;kg
;Riz blanc 1 kg;Épicerie sèche;2500;1800;paquet

(Sans Code, un code IMP-xxx est généré automatiquement.)

Fichiers templates :

  • database/data/catalogue_import_template.csv — format complet (Code, Nom, Catégorie, Prix, Unité)
  • database/data/grocery_import_template.csv — format alimentaire (categorie, nom, prix, unite)

7. Modèle pour import de produits alimentaires (boutique alimentaire)

Pour importer des produits (page Produits → Importer depuis CSV), le fichier doit respecter le format ci‑dessous. Vous pouvez utiliser ce modèle pour préparer vos lignes dans Excel puis enregistrer en CSV (séparateur : virgule ou point‑virgule).

Fichier template fourni : database/data/grocery_import_template.csv

Colonne Alias accepté Description Exemple
categorie category Nom catégorie Fruits et Légumes
nom name, produit Nom du produit Tomates fraîches
prix price Prix de vente 1500
unite unit Unité de vente kg, paquet, pièce

Exemple :

categorie,nom,prix,unite
Fruits et Légumes,Tomates fraîches,1500,kg
Épicerie sèche,Riz blanc 1 kg,2500,paquet

Voir aussi : IMPORT_PRODUITS_ALIMENTAIRES.md.
Pour l’import catalogue (tous types de boutiques), voir la section 6 ci-dessus.


Utilisation dans Excel

  1. Exporter depuis l’app : utilisez les boutons « Export Excel » dans chaque rapport ; le CSV téléchargé s’ouvre dans Excel (UTF-8 avec BOM).
  2. Modèles vierges : dans database/data/export_templates/ vous trouverez des CSV avec uniquement les en‑têtes (et une ligne d’exemple), pour remplir ou comparer.
  3. Enregistrer en CSV : Fichier → Enregistrer sous → Type « CSV (délimité par des virgules) » ou « CSV UTF-8 ».