Module Factures Clients (développeur)

From Dolibarr ERP CRM Wiki
Jump to navigation Jump to search
Facture
Numéro/ID du module 30
Doc utilisateur du module Module Factures Clients
Doc développeur du module Cette page

Fonction du module

Le module Facture permet de gérer dans Dolibarr les entités suivantes:

  • Factures clients
  • Lignes de factures

Les factures fournisseurs sont gérées par le Module Fournisseurs (développeur).

Les arrondis de calcul de TVA doivent se faire "au plus près".

Exemple:

de 0,0000 à 0,0049 --> 0,00

de 0,0050 à 0,0099 --> 0,01

Entité Facture

La classe PHP pour manipuler ces objets est le fichier htdocs/compta/facture/class/facture.class.php.

Elle contient les méthodes principales CRUD pour créer (C), lire (R), mettre à jour (U) et effacer (D) un enregistrement.

Règles de gestion:

  • Une facture a plusieurs lignes de factures
  • Il est possible de rattacher 1 à n contacts à une facture
  • A compléter...

Cycle de vie:

  • Une facture peut être créée en mode brouillon (Provoque appel du trigger BILL_CREATE)
  • Une facture peut être modifiée (Provoque appel du trigger BILL_UPDATE)
  • Une facture peut être validée (Provoque appel du trigger BILL_VALIDATE)
  • Une facture peut recevoir un paiement
  • Une facture peut être classée abandonnée ou payée (Provoque appel du trigger BILL_CANCEL ou BILL_UPDATE)

Entité Ligne de Facture

La classe PHP pour manipuler ces objets est le fichier htdocs/compta/facture/class/facture.class.php.

Elle contient les méthodes principales CRUD pour créer (C), lire (R), mettre à jour (U) et effacer (D) un enregistrement.

  • Une ligne de facture est soit de type produit, soit de type service (au choix si les modules Produits and Services sont tous 2 activés).
  • Une ligne de facture représente un produit/service dans une facture (avec un prix unitaire, une tva, une quantité et une réduction de ligne)
  • Chaque facture a 1 à n lignes de produits

Entité Facture récurrentes

La classe PHP pour manipuler ces objets est le fichier htdocs/compta/facture/class/facture-rec.class.php.

Elle contient les méthodes principales CRUD pour créer (C), lire (R), mettre à jour (U) et effacer (D) un enregistrement.

Permissions

  • ->facture->lire
  • ->facture->creer
  • ->facture->modifier
  • ->facture->valider
  • ->facture->envoyer
  • ->facture->paiment
  • ->facture->supprimer
  • ->facture->facture->export

Tables SQL

Constantes

  • FACTURE_ADDON_PDF
  • FACTURE_ADDON
  • FAC_FORCE_DATE_VALIDATION

Scripts