Aide & documentation

L'application regroupe tout ce qu'il faut pour gérer la facturation de ton activité :

1. 1

   Renseigner ton entreprise

   SIRET, TVA, RCS, banque (IBAN/BIC), conditions de paiement. Indispensable pour que les PDF de devis et factures soient légalement conformes.

2. 2

   Créer ton premier client

   Particulier, pro français, pro UE ou hors UE. La référence (CLI-001…) est générée automatiquement.

3. 3

   Émettre un devis

   Ajoute des lignes (prestations, fournitures…), génère le PDF, envoie-le par email au client.

4. 4

   Le devis est accepté

   Passe-le en statut « Accepté » : tu peux alors créer une facture d'acompte (30%) puis la facture finale qui déduira automatiquement l'acompte versé.

5. 5

   Suivre les paiements

   Coche les factures payées. Tu vois en temps réel ton chiffre d'affaires encaissé et ce qui te reste à encaisser.

Le devis est une proposition commerciale non engageante côté facturation tant qu'il n'est pas accepté.

Cycle de vie

• Brouillon — tu travailles dessus, rien n'est figé, pas de numéro.
• Envoyé — un numéro D-2026-XXX est attribué, le PDF est figé.
• Accepté — le client a signé. Tu peux générer un acompte et/ou la facture finale.
• Refusé — le client a décliné, le devis reste en archive.
• Expiré — passé la date de validité, automatique (ou manuel).

Numérotation

Séquentielle annuelle, format D-{ANNEE}-{NUM} (ex : D-2026-001). Le compteur repart à 1 chaque 1er janvier, conformément à la réglementation.

PDF

Le PDF est téléchargeable depuis la fiche du devis (bouton PDF). Il est généré avec le logo et les couleurs de l'entreprise, l'adresse complète, les CGV au pied et un emplacement signature client. Le PDF est recalculé à chaque clic — si tu modifies un brouillon, le nouveau PDF reflète les modifs.

Envoi par email

Bouton « Envoyer par email » sur la fiche : ouvre une modale, pré-remplit l'objet et le corps avec le nom du client. Le PDF est joint. Si le client est invité (sans compte), l'adresse Reply-To est positionnée sur l'email du devis pour que les réponses te reviennent.

Chaque ligne d'un devis ou d'une facture peut être rattachée à une section (Fourniture, Pose, Main d'œuvre, Démolition…). Les lignes sont alors regroupées visuellement, avec un sous-total HT par groupe.

Comment l'utiliser

1. 1

   Dans le formulaire

   Première colonne du tableau des lignes, intitulée « Section ». Tape le nom du groupe (ex : Fourniture). Un auto-complétion propose Fourniture / Pose / Main d'œuvre / Démolition, mais tu peux taper ce que tu veux.

2. 2

   Cohérence des libellés

   Toutes les lignes avec exactement le même texte de section seront regroupées. Attention aux fautes de frappe (« Pose » et « pose » seraient considérées différentes).

3. 3

   Ordre des sections

   L'ordre dans le PDF et la fiche correspond à l'ordre d'apparition des lignes : la première section rencontrée s'affiche en premier.

4. 4

   Lignes hors section

   Tu peux laisser le champ Section vide : ces lignes apparaissent avant les sections, sans regroupement.

Astuce TVA mixte (BTP)

En rénovation, la fourniture est à 20% mais la pose peut bénéficier de la TVA réduite à 10% (ou 5,5% pour la rénovation énergétique). Saisis simplement le bon taux de TVA par ligne — la section sert juste à grouper visuellement, le calcul de TVA est ligne par ligne.

Une facture engage le client : elle est numérotée séquentiellement et ne peut plus être modifiée une fois émise (sauf via un avoir).

Deux façons de créer

• Directe — depuis Nouvelle facture, saisie libre des lignes.
• Depuis un devis accepté — sur la fiche du devis, bouton « Convertir en facture ». Toutes les lignes et sections sont recopiées à l'identique. C'est la voie recommandée pour garder la traçabilité (champ « Issue du devis D-XXX » sur la facture).

Cycle de vie

• Brouillon — modifiable, pas de numéro.
• À payer — numéro F-2026-XXX attribué, échéance fixée.
• Payée — date de paiement enregistrée.
• En retard — l'échéance est dépassée.
• Annulée — uniquement si jamais transmise. Sinon, passe par un avoir.

Mentions légales

Le PDF inclut automatiquement :

• SIRET, SIREN, TVA intracom, RCS, capital social (depuis Paramètres)
• Mention LME : pénalités de retard et indemnité forfaitaire de 40 €
• IBAN/BIC pour règlement par virement
• Auto-liquidation TVA art. 283-2 si client pro UE
• Date d'émission + date d'échéance (par défaut 30 jours)

Une facture d'acompte est émise avant la facture finale, pour réclamer un versement partiel (souvent 30%). Elle a une TVA propre et entre en comptabilité au moment où elle est payée.

Créer un acompte

1. 1

   Le devis doit être accepté

   Le bouton « Créer facture d'acompte » apparaît uniquement sur les devis en statut Accepté.

2. 2

   Choisir le pourcentage

   Modale qui demande le % (par défaut 30%). Tu vois en direct le montant TTC qui sera facturé.

3. 3

   Le système crée la facture

   Numéro spécifique FA-2026-XXX. Le montant est ventilé par taux de TVA pour rester conforme.

4. 4

   Lors de la facture finale

   Quand tu génères la facture finale depuis le devis, une ligne négative « Acompte FA-XXX déjà versé » est ajoutée automatiquement pour ne pas facturer deux fois.

Un avoir annule tout ou partie d'une facture déjà émise. Il est obligatoire pour corriger une facture, on ne supprime jamais une facture validée.

Cas typiques : erreur sur le montant, retour de marchandise, geste commercial, annulation totale d'une commande.

L'avoir reprend les lignes en négatif et porte un numéro AV-2026-XXX.

Quatre types de client

• Particulier — TVA 20% (ou 10% / 5,5% rénovation), pas de SIRET.
• Pro France — SIRET + n° TVA français obligatoires, TVA 20%.
• Pro UE — n° TVA intracom obligatoire. Case « auto-liquidation » disponible : la TVA n'est pas appliquée et la mention art. 283-2 du CGI apparaît sur le PDF.
• Pro hors UE — export, TVA à 0%, mention exportation.

Référence

Format CLI-XXX, séquentielle. Visible sur la fiche client et sur les PDF.

Fiche détail

Pour chaque client, la fiche affiche les coordonnées complètes + l'historique de tous les documents émis (devis, factures, acomptes).

À partir de 2026-2027, toute facture B2B en France devra transiter par une Plateforme de Dématérialisation Partenaire (PDP). L'application est prête : génération de Factur-X et transmission via Iopole.

Format Factur-X

Le PDF de chaque facture est généré au format Factur-X profil BASIC : c'est un PDF/A-3 avec un XML CII (Cross Industry Invoice) embarqué. Lisible par un humain ET parsable par les logiciels comptables.

Transmission

Sur la fiche d'une facture émise, panneau « PDP » :

• Bouton Transmettre : envoie la facture à la PDP du destinataire (via Iopole).
• Timeline en 5 étapes : Créée → Transmise → Acceptée → Délivrée → Payée.
• Webhook entrant pour recevoir les changements de statut en temps réel.

Inbox (factures reçues)

Page Inbox : tes factures fournisseurs reçues via la PDP. Pour l'instant, l'opérateur par défaut est mock (simulation) — quand les endpoints Iopole sandbox seront documentés, on bascule en PDP_OPERATOR=iopole dans le .env.

Page Paramètres — à remplir AVANT tout devis ou facture, sinon le PDF sortira incomplet.

• Identité : nom commercial, raison sociale, SIRET, SIREN, n° TVA, RCS, capital, code NAF
• Adresse : ligne 1, ligne 2, CP, ville, pays
• Contact : email, téléphone, site web
• Banque : IBAN, BIC (apparaissent sur les factures pour règlement par virement)
• Conditions de paiement : délai par défaut (30j…), pénalités, escompte
• Régime TVA : franchise en base / réel simplifié / réel normal
• Branding : couleurs primaire et accent pour les PDF (par défaut navy + or)

• Auto-complétion section : tape juste « F » dans la colonne section pour voir Fourniture proposé.
• Conversion devis → facture : un seul clic, garde la liaison parent/enfant visible des deux côtés.
• Multi-acomptes : tu peux faire plusieurs acomptes sur un même devis ; la facture finale les déduit tous.
• Brouillon : tant qu'un document est en brouillon, il n'a pas de numéro et peut être modifié librement. Une fois envoyé, le numéro est figé.
• PDF figé sur email : modifier un brouillon ne change pas le PDF déjà envoyé au client. Le client garde sa version, toi tu vois la dernière.
• Échap ferme les modales (acompte, envoi email).