# Guide utilisateur : données de facturation et facturation

Documentation utilisateur sur la préparation des données, les tarifs, les contrôles avant facturation et la facturation elle-même. Même présentation que les guides précédents (charte ADLER, encadrés, figures numérotées).

## Fichiers livrés

- `docs/Guide_utilisateur_facturation.docx`
- `docs/Guide_utilisateur_facturation.pdf` (24 pages, 27 figures)

## Contenu

1. Vue d'ensemble : rôle de chaque fiche, prix figé sur le BL, étapes, menus.
2. Fiche client : Identification (code comptable, Groupe = client payeur, Basculer tarif), Présentation facture (5 découpages), cases Client non facturable / Adresse chantier pour facturation / Relevé / Chorus, cadre Règlement, identifiants et facture électronique.
3. Adresses de facturation (`t_adresse_facturation`, bouton « Adresse Fact ») et onglet Facturation du chantier (Adresse fac, Mode réglement, Echéance, TVA). Règle d'adresse imprimée.
4. Famille et sous-famille client (tarif, taxes, stats ; recalcul des BL non facturés au changement).
5. Articles (Formule, Service, Ajout, Produit, Zone), Groupe tarif, Centrale (Société, Activité, Groupe centrale tarif).
6. Écran Tarifs : grille, remise groupe tarifaire, prix par article (double-clic, fenêtre avec « Origine »). Exemple réel : formule C25 XF1 D11 S3, prix de base 158 €, remise groupe 23 de 63 € pour le client SMBA, prix 95 €, origine « client ».
7. Ordre de recherche du prix (commande > chantier > client > sous-famille > groupe centrale > société > prix de base), pièges, Hausse prix et Opération tarif.
8. Vérifier avant de facturer : BL non facturables, Lignes de BL non facturables, Contrôle BL, pré-facturation, liste de contrôle.
9. Génération des factures : zones, messages bloquants, numérotation (exemple F0126090017).
10. Après la génération : liste et fiche facture, Opération facture, export facture électronique.
11. Opérations sur les factures (ajouté dans un second temps) : avoir depuis une facture (onglet « Saisie ligne avoir », colonne Av/Fac PUHT), facture ou avoir manuel (bouton Ajouter, saisie des lignes dans « Corps de facture »), facture d'acompte et déduction sur la facture définitive (écran `/facture_laravel`, hors menu), défacturer un BL, valider pour la compta (fiche ou liste), export comptable, génération et envoi des relevés.
12. FAQ.

## Ajout du chapitre 11 : points vérifiés dans le code

- Avoir : `public/facture/generer_avoir.php` reprend la quantité de chaque ligne cochée et le prix saisi en « Av/Fac PUHT » (prérempli avec le PU de la facture, `facture.js`) ; motif obligatoire selon `parametre_motif_avoir_obligatoire` ; avoir créé non validé.
- Validation compta : `valider_facture_compta.php` (`facture_validee = 1`) ; l'impression PDF valide aussi si `parametre_valider_facture_compta_impression = 1` ; validation groupée par le bouton Valider de la liste (`valider_facture_compta_multiple.php`).
- Export comptable : la liste ne montre que les factures `facture_validee = 1` et `facture_exportee = 0` ; le bouton Export ouvre le format défini par `parametre_nom_export_compta`, qui marque les factures exportées.
- Défacturer : remet `facture_numero` à NULL sur le ou les BL, sans toucher à la facture (legacy sans contrôle de droit ; écran Laravel : profil facture 3/4/5 et droit « Défacturer un BL »).
- Acompte : création « Facture acompte » et déduction (`deduire_acomptes`) dans `/facture_laravel` ; prérequis `parametre_article_deduction_acompte_id` ; supprimer une ligne « Déduction acompte » rend l'acompte de nouveau déductible (`supprimer_ligne`).
- Relevés : `generation_releve_facture_generer_releve.php` regroupe les factures sans relevé par société, adresse de facturation, mode de règlement **et échéance** ; société obligatoire ; date du relevé = date de fin.

## Correction apportée au guide

La case client « Relevé de facture » était présentée comme déclenchant les relevés. Elle n'est lue par aucun traitement (seulement par les imports de clients) : la génération des relevés prend toutes les factures de la période selon les filtres. Le guide le dit désormais.

## Script commun

`guide_commun.php` : dans `figure()`, l'image est placée dans un paragraphe `keepNext` pour rester sur la même page que sa légende.

## Captures du chapitre 11

Faites sans rien enregistrer : fenêtres de création ouvertes puis fermées, case cochée puis décochée dans « Saisie ligne avoir ». Colonne e-mail masquée dans la liste des relevés. La fenêtre des acomptes est vide (le seul acompte de la base est déjà déduit et concerne un particulier).

## Points vérifiés dans le code

- Ordre et conditions des niveaux de tarif : `app/Services/article_tarif_service.php` (`calculerNiveauTarif`, `origineTarif`). Un niveau n'est atteint que si tous les niveaux supérieurs sont renseignés (client sans sous-famille ou centrale sans groupe centrale tarif ⇒ pas de tarif client/chantier).
- Le R.% d'un tarif article est ignoré par le calcul ; dans la fenêtre de saisie, la remise % sert seulement à calculer le prix enregistré (`public/tarif/verification_article/verification_article_formule.php`).
- Exclusions silencieuses de la génération (BL facturé ou annulé, client non facturable, adresse/mode de règlement/échéance du chantier à 0) : `public/generation_facture/generation_facture_selectionner_client.php`, requêtes de `facturer()`.
- Critères de l'écran BL non facturables : `app/Http/Controllers/bl_controller.php` (filtre sur la date de livraison, case « Inclure bl préfa »).
- Le champ « Remise » de la sous-famille client n'est utilisé dans aucun calcul de prix.
- « Basculer tarif » ouvre `/tarif/?client_id=…&sous_famille_id=…` (`resources/views/client/form_script.blade.php`).

## Méthode

- Docx généré avec PHPWord à partir du script commun `guide_commun.php` des guides précédents (scratchpad, non versionné) ; PDF exporté par Word (COM).
- Captures faites avec html2canvas dans l'application locale (client 2L PROM, chantier 007 01, client SMBA pour les tarifs, factures de septembre 2026). Elles passaient par deux fichiers temporaires `public/_capture_doc_tmp.php` et `public/_capture_doc_tmp.js`, supprimés à la fin. Les factures de clients particuliers ont été masquées de la capture de la liste.

## Anomalies relevées (non corrigées)

- Fiche client, cadre Identifiants : la zone « Code société QR » affiche le texte `null` quand elle est vide.
- Libellés avec fautes à l'écran : « Adressse1/2/3 » (adresse de facturation), « Ventillation » (génération), « Pré-factruration annulée ».
- La génération des factures n'affiche aucun message de fin ni récapitulatif.
