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
- 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).
- 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. - Enregistrer en CSV : Fichier → Enregistrer sous → Type « CSV (délimité par des virgules) » ou « CSV UTF-8 ».