Créer et Modifier une Facture Client

Le module Factures d’HtkDoli permet de créer et d’éditer facilement des factures clients. L’application est conçue pour fonctionner de manière fluide même avec une connectivité réseau limitée.

Mode de Création et Édition

L’écran de formulaire gère deux scénarios principaux avec des comportements spécifiques :

1. Création d’une nouvelle facture (Offline-First)

   • Lors de la création, la facture est enregistrée localement sur votre appareil de façon immédiate avec un identifiant temporaire (ex: (PROV)).
   • L’application met en file d’attente l’envoi de la facture vers votre serveur Dolibarr. Cela vous permet de continuer à utiliser l’application sans attendre la réponse du serveur.
   • Le statut initial lors de la création est toujours “Brouillon”.

2. Édition d’une facture existante (Optimistic UI)

   • Toute modification apportée à une facture existante (déjà synchronisée avec le serveur) est appliquée instantanément dans l’interface de l’application.
   • Les changements sont ensuite mis en file d’attente pour être envoyés et mis à jour sur votre instance Dolibarr en arrière-plan.

Remplir les Informations de la Facture

L’écran de création / modification est divisé en plusieurs sections essentielles.

1. Sélection du Client (Tiers)

Ce champ est obligatoire.

• Vous devez sélectionner un client parmi la liste de vos tiers enregistrés et synchronisés.
• L’application filtre automatiquement les tiers pour n’afficher que ceux avec lesquels une facture peut être liée.

2. Dates

• Date de facturation : La date d’émission de la facture (par défaut, la date du jour).
• Date d’échéance : La date limite à laquelle la facture doit être réglée.

3. Conditions et Projet

• Conditions de règlement : Délais accordés (ex. 30 jours, à réception, etc.), récupérés depuis le dictionnaire de votre serveur Dolibarr.
• Mode de règlement : Moyens de paiement acceptés (ex. Virement bancaire, Carte bancaire, Chèque), également issus des configurations Dolibarr.
• Projet lié : Optionnellement, vous pouvez associer cette facture à un projet existant sur Dolibarr.

4. Lignes de la Facture (Produits et Services)

Vous pouvez ajouter autant de lignes que nécessaire à votre facture. Pour chaque ligne, une fenêtre dédiée vous permet de spécifier :

• Produit ou Service : Vous pouvez rechercher dans votre catalogue de produits/services. Sélectionner un produit remplit automatiquement sa description, son prix et sa TVA.
• Scan de Code-barres : L’application intègre une fonctionnalité permettant de scanner le code-barres d’un produit en utilisant l’appareil photo, afin de le retrouver rapidement dans votre base de données.
• Description : Texte libre détaillant la prestation ou le produit.
• Quantité et Prix Unitaire HT.
• Taux de TVA (%).
• Remise (%) accordée spécifiquement sur cette ligne.

5. Notes

• Note publique : Information affichée sur la facture générée (PDF) visible par le client.
• Note privée : Information interne à destination des collaborateurs, non visible sur le document final.

Validation et Enregistrement

Une fois le formulaire rempli, le bouton d’enregistrement (Créer ou Enregistrer) permet de valider les données. S’il manque des informations obligatoires (comme le client), le système vous avertira en bas de l’écran. Après sauvegarde, vous êtes automatiquement redirigé vers la vue précédente, tandis que l’application s’occupe de la synchronisation de la facture en arrière-plan.