Retour à la présentation
🏷️

Avoirs Founisseurs NOUVEAU

Le module Avoirs Fournisseurs permet de déclarer et d'appliquer les avoirs reçus des fournisseurs (retours de marchandise non conforme, remises commerciales, erreurs de facturation, produits manquants…). Chaque avoir appliqué génère automatiquement une ligne négative dans les achats du mois, ce qui déduit son montant du total des achats dans la synthèse financière mensuelle et annuelle. Le coût matière reflète ainsi la consommation réelle nette des remises obtenues. Ce module répond à un besoin quotidien des services de restauration collective qui reçoivent régulièrement des avoirs fournisseurs mais ne disposaient d'aucun outil dédié pour les tracer et les intégrer automatiquement dans leurs indicateurs financiers.

## Fonctionnalités principales

### 1. 📋 Déclaration d'un avoir depuis la page Achats

Depuis la liste des achats, chaque ligne non-avoir affiche un bouton 🏷️ qui ouvre un modal de déclaration directement pré-rempli avec le fournisseur et les montants de l'achat source.

- Fournisseur pré-rempli (lecture seule)
- Description libre de l'avoir (ex. : *Produit non conforme — salade iceberg*)
- Sélection du taux de TVA (20 %, 10 %, 5,5 %, 2,1 %, 0 %) avec recalcul automatique HT ↔ TTC
- Montants HT et TTC modifiables indépendamment avec recalcul croisé
- Champ Notes optionnel (raison du retour, numéro de bon de livraison…)
- L'avoir est créé en statut **En attente** : aucun impact financier immédiat
- Lien direct vers la page Avoirs pour application ultérieure

### 2. 📂 Page dédiée Avoirs — gestion du cycle de vie

La page **/avoirs** liste tous les avoirs avec leur statut et permet de les gérer.

- Affichage séparé : **En attente** (modifiables, applicables) et **Appliqués** (lecture seule, archivés)
- Informations visibles : fournisseur, description, montant HT, montant TTC, taux TVA, date de création, notes, achat source lié
- **Application** : transforme l'avoir en attente en ligne négative dans les achats du mois courant
- **Suppression** : possible uniquement sur les avoirs en attente (avant application)
- Accès complet aux rôles admin, gestionnaire et cuisinier ; consultation seule pour le rôle lecteur

### 3. 💸 Application de l'avoir — ligne négative dans les achats

Lorsqu'un avoir est appliqué depuis la page Avoirs :

- L'avoir passe en statut **Appliqué** avec référence à l'achat 
- La ligne avoir est **non convertible en stock** 

### 4. 📊 Affichage dans la page Achats — section séparée

Les lignes d'avoir n'apparaissent **pas** dans le tableau principal des achats (pas de checkbox, pas de conversion en stock). Elles sont affichées dans une **section dédiée** sous le tableau principal :

- Carte avec bordure orange, titre *Avoirs appliqués ce mois*
- Tableau lecture seule : date, fournisseur, description, montant HT (rouge), montant TTC (rouge)
- Ligne **Total avoirs** en rouge
- Ligne **Net achats (après avoirs)** en vert = Total achats − Total avoirs

### 5. 📈 Impact sur la synthèse financière mensuelle et annuelle

Les avoirs appliqués sont automatiquement intégrés dans tous les indicateurs financiers :

**Mensuel :**

- `total_achats` = somme des achats hors lignes avoir
- `total_avoirs` = somme des montants absolus des lignes avoir 
- `achats_nets = total_achats − total_cessions − total_avoirs`
- `achats_consommés = achats_nets + stock_début − stock_fin`
- La carte synthèse mensuelle affiche les avoirs déduits en orange avec flèche descendante
- Tous les ratios (coût matière/couvert, taux de coût matière) sont calculés sur `achats_consommés`

**Annuel (tableau récapitulatif) :**

- Colonne **Avoirs** dédiée (fond orange) sur chaque mois et sur la ligne Total Année
- `achats_consommés_annuel = (total_achats − total_cessions − total_avoirs) + stock_début − stock_fin`
- Résultat d'exploitation et résultat complet reflètent les avoirs sur l'année entière

## Cas d'usage typiques

- **Retour de marchandise non conforme** : livraison de légumes abîmés, le fournisseur émet un avoir partiel → déclaré et appliqué le jour même
- **Erreur de facturation** : doublon ou quantité facturée supérieure à la livraison → avoir pour le delta
- **Remise commerciale ponctuelle** : négociation en fin de mois, le fournisseur accorde un avoir global → tracé en une ligne
- **Produit manquant** : article absent de la livraison mais facturé → avoir pour la valeur de l'article
- **Avoir sur bon de commande** : le fournisseur rembourse partiellement une commande passée via le module Commandes

## Points forts exclusifs

✅ **Déclaration en un clic** : depuis la ligne d'achat concernée, sans ressaisie du fournisseur ni des montants  
✅ **Cycle de vie traçable** : statut En attente → Appliqué avec horodatage et référence double (achat source + achat application)  
✅ **Isolation totale** : les lignes avoir ne polluent jamais la liste principale des achats ni la conversion en stock  
✅ **Impact financier automatique** : dès l'application, la synthèse reflète les achats nets sans aucune intervention manuelle  
✅ **Double déduction** : les avoirs sont déduits à la fois de `total_achats` (trésorerie) et de `achats_consommés` (performance réelle)
Retour à la présentation